You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<summary>Gets or sets a value that specifies the policy used to convert a property's name on an object to another format, such as camel-casing. </summary>
342
-
<value>One of the enum values from <seecref="T:System.Text.Json.JsonNamingPolicy" />.</value>
341
+
<summary>Gets or sets a value that specifies the policy used to convert a property's name on an object to another format, such as camel-casing, or <seelangword="null" /> to leave property names unchanged.</summary>
342
+
<value>A property naming policy, or <seelangword="null" /> to leave property names unchanged.</value>
<paramname="input">A read-only span of characters that contains a version number to convert.</param>
1422
+
<summary>Converts the specified read-only span of characters that represents a version number to an equivalent <seecref="T:System.Version" /> object.</summary>
1423
+
<returns>An object that is equivalent to the version number specified in the <paramrefname="input" /> parameter.</returns>
1424
+
<remarks>
1425
+
<formattype="text/markdown"><![CDATA[
1426
+
1427
+
## Remarks
1428
+
1429
+
The `input` parameter must have the following format:
1430
+
1431
+
`major.minor[.build[.revision]]`
1432
+
1433
+
where `major`, `minor`, `build`, and `revision` are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Optional components are shown in square brackets ([ and ]). The components must appear in the specified order and must be separated by periods.
1434
+
1435
+
]]></format>
1436
+
</remarks>
1437
+
<exceptioncref="T:System.ArgumentException"><paramrefname="input" /> has fewer than two or more than four version components.</exception>
1438
+
<exceptioncref="T:System.ArgumentOutOfRangeException">At least one component in <paramrefname="input" /> is less than zero.</exception>
1439
+
<exceptioncref="T:System.FormatException">At least one component in <paramrefname="input" /> is not an integer.</exception>
1440
+
<exceptioncref="T:System.OverflowException">At least one component in <paramrefname="input" /> represents a number that is greater than <seecref="F:System.Int32.MaxValue" />.</exception>
1425
1441
</Docs>
1426
1442
</Member>
1427
1443
<MemberMemberName="Parse">
@@ -1467,12 +1483,9 @@
1467
1483
## Remarks
1468
1484
The `input` parameter must have the following format:
1469
1485
1470
-
```
1486
+
`major.minor[.build[.revision]]`
1471
1487
1472
-
major.minor[.build[.revision]]
1473
-
```
1474
-
1475
-
where *major*, *minor*, *build*, and *revision* are the string representations of the version number's four components: major version number, minor version number, build number, and revision number. Optional components are shown in square brackets ([ and ]). The components must appear in the specified order, and must be separated by periods.
1488
+
where `major`, `minor`, `build`, and `revision` are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Optional components are shown in square brackets ([ and ]). The components must appear in the specified order and must be separated by periods.
1476
1489
1477
1490
> [!IMPORTANT]
1478
1491
> Because the string representation of a version number must conform to a recognized pattern, applications should always use exception handling when calling the <xref:System.Version.Parse%2A> method to parse user input. Alternatively, you can call the <xref:System.Version.TryParse%2A> method to parse the string representation of a version number and return a value that indicates whether the parse operation succeeded.
<paramrefname="input" /> is <seelangword="null" />.</exception>
1494
-
<exceptioncref="T:System.ArgumentException">
1495
-
<paramrefname="input" /> has fewer than two or more than four version components.</exception>
1505
+
<exceptioncref="T:System.ArgumentNullException"><paramrefname="input" /> is <seelangword="null" />.</exception>
1506
+
<exceptioncref="T:System.ArgumentException"><paramrefname="input" /> has fewer than two or more than four version components.</exception>
1496
1507
<exceptioncref="T:System.ArgumentOutOfRangeException">At least one component in <paramrefname="input" /> is less than zero.</exception>
1497
1508
<exceptioncref="T:System.FormatException">At least one component in <paramrefname="input" /> is not an integer.</exception>
1498
1509
<exceptioncref="T:System.OverflowException">At least one component in <paramrefname="input" /> represents a number that is greater than <seecref="F:System.Int32.MaxValue" />.</exception>
<paramname="version">An object to compare, or <seelangword="null" />.</param>
1599
+
<summary>Compares the current <seecref="T:System.Version" /> object to a specified object and returns an indication of their relative values.</summary>
1600
+
<returns>A signed integer that indicates the relative values of the two objects, as shown in the following table:
1601
+
<listtype="table">
1602
+
<listheader>
1603
+
<term>Return value</term>
1604
+
<description>Meaning</description>
1605
+
</listheader>
1606
+
<item>
1607
+
<term>Less than zero</term>
1608
+
<description>The current <seecref="T:System.Version" /> object is a version before <paramrefname="version" />.</description>
1609
+
</item>
1610
+
<item>
1611
+
<term>Zero</term>
1612
+
<description>The current <seecref="T:System.Version" /> object is the same version as <paramrefname="version" />.</description>
1613
+
</item>
1614
+
<item>
1615
+
<term>Greater than zero</term>
1616
+
<description>The current <seecref="T:System.Version" /> object is a version subsequent to <paramrefname="version" />.
1617
+
1618
+
-or-
1619
+
1620
+
<paramrefname="version" /> is <seelangword="null" />.</description>
1621
+
</item>
1622
+
</list>
1623
+
</returns>
1624
+
<remarks>
1625
+
<formattype="text/markdown"><![CDATA[
1626
+
1627
+
## Remarks
1628
+
1629
+
This member is an explicit interface member implementation.
<paramname="input">A read-only span of characters that contains a version number to convert.</param>
1865
+
<paramname="result">When this method returns, the <seecref="T:System.Version" /> equivalent of the number that is contained in <paramrefname="input" />, if the conversion succeeded. If <paramrefname="input" /> is <seelangword="null" />, <seecref="F:System.String.Empty" />, or if the conversion fails, <paramrefname="result" /> is <seelangword="null" /> when the method returns.</param>
1866
+
<summary>Tries to convert the specified read-only span of characters representing a version number to an equivalent <seecref="T:System.Version" /> object, and returns a value that indicates whether the conversion succeeded.</summary>
1867
+
<returns><seelangword="true" /> if the <paramrefname="input" /> parameter was converted successfully; otherwise, <seelangword="false" />.</returns>
1868
+
<remarks>
1869
+
<formattype="text/markdown">
1870
+
<![CDATA[
1871
+
1872
+
## Remarks
1873
+
1874
+
The `TryParse` method is similar to the <xref:System.Version.Parse%2A> method, except that it doesn't throw an exception if the conversion fails. Instead, it returns `false` if `input` is `null`, has fewer than two or more than four components, has at least one component that is not an integer, has at least one component that is less than zero, or has at least one component that is greater than <xref:System.Int32.MaxValue?displayProperty=nameWithType>.
1875
+
1876
+
For the parse operation to succeed, the `input` parameter must be in the following format:
1877
+
1878
+
`major.minor[.build[.revision]]`
1879
+
1880
+
where `major`, `minor`, `build`, and `revision` are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Optional components are shown in square brackets ([ and ]). The components must appear in order and must be separated by periods.
<paramname="input">A string that contains a version number to convert.</param>
1865
1922
<paramname="result">When this method returns, contains the <seecref="T:System.Version" /> equivalent of the number that is contained in <paramrefname="input" />, if the conversion succeeded. If <paramrefname="input" /> is <seelangword="null" />, <seecref="F:System.String.Empty" />, or if the conversion fails, <paramrefname="result" /> is <seelangword="null" /> when the method returns.</param>
1866
1923
<summary>Tries to convert the string representation of a version number to an equivalent <seecref="T:System.Version" /> object, and returns a value that indicates whether the conversion succeeded.</summary>
1867
-
<returns>
1868
-
<seelangword="true" /> if the <paramrefname="input" /> parameter was converted successfully; otherwise, <seelangword="false" />.</returns>
1924
+
<returns><seelangword="true" /> if the <paramrefname="input" /> parameter was converted successfully; otherwise, <seelangword="false" />.</returns>
1869
1925
<remarks>
1870
1926
<formattype="text/markdown"><![CDATA[
1871
1927
1872
1928
## Remarks
1873
-
The <xref:System.Version.TryParse%2A> method is similar to the <xref:System.Version.Parse%2A> method, except that it does not throw an exception if the conversion fails. Instead, it returns `false` if `input` is null, has fewer than two or more than four components, has at least one component that is not an integer, has at least one component that is less than zero, or has at least one component that is greater than <xref:System.Int32.MaxValue?displayProperty=nameWithType>.
1929
+
The `TryParse` method is similar to the <xref:System.Version.Parse%2A> method, except that it doesn't throw an exception if the conversion fails. Instead, it returns `false` if `input` is `null`, has fewer than two or more than four components, has at least one component that is not an integer, has at least one component that is less than zero, or has at least one component that is greater than <xref:System.Int32.MaxValue?displayProperty=nameWithType>.
1874
1930
1875
1931
For the parse operation to succeed, the `input` parameter must be in the following format:
1876
1932
1877
-
```
1878
-
1879
-
major.minor[.build[.revision]]
1880
-
```
1933
+
`major.minor[.build[.revision]]`
1881
1934
1882
-
where *major*, *minor*, *build*, and *revision* are the string representations of the version number's four components: major version number, minor version number, build number, and revision number. Optional components are shown in square brackets ([ and ]). The components must appear in order, and must be separated by periods.
1935
+
where `major`, `minor`, `build`, and `revision` are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Optional components are shown in square brackets ([ and ]). The components must appear in order and must be separated by periods.
<summary>Provides types for creating <seecref="T:System.Threading.Tasks.ValueTask" /> and <seecref="T:System.Threading.Tasks.ValueTask`1" /> optimized to minimize allocations. The <seecref="T:System.Threading.Tasks.Sources.IValueTaskSource" /> and <seecref="T:System.Threading.Tasks.Sources.IValueTaskSource`1" /> interfaces can be implemented on objects used to provide the backing implementations for <seecref="T:System.Threading.Tasks.ValueTask" /> and <seecref="T:System.Threading.Tasks.ValueTask`1" />, and <seecref="T:System.Threading.Tasks.Sources.ManualResetValueTaskSourceCore`1" /> can be used to implement the core logic necessary to support the task lifecycle. These are advanced types and need only be used in specialized situations where performance is paramount.</summary>
0 commit comments