diff --git a/xml/System.Text.Json/JsonElement.xml b/xml/System.Text.Json/JsonElement.xml index 8bf38038913..1e38b023a91 100644 --- a/xml/System.Text.Json/JsonElement.xml +++ b/xml/System.Text.Json/JsonElement.xml @@ -1069,7 +1069,7 @@ For other types, the value of is - When the method returns, contains the byte equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . @@ -1155,7 +1155,7 @@ This method does not create a byte array representation of values other than Bas - When this method returns, contains the date and time value equivalent to the current JSON string. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. Attempts to represent the current JSON string as a . if the string can be represented as a ; otherwise, . @@ -1194,7 +1194,7 @@ This method only creates a DateTime representation of JSON strings that conform - When this method returns, contains the date and time equivalent to the current JSON string. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. Attempts to represent the current JSON string as a . if the string can be represented as a ; otherwise, . @@ -1233,7 +1233,7 @@ This method only creates a DateTimeOffset representation of JSON strings that co - When this method returns, contains the decimal equivalent of the current JSON number. + When this method returns, contains the decimal equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . @@ -1272,7 +1272,7 @@ This method does not parse the contents of a JSON string value. - When this method returns, contains a double-precision floating point value equivalent to the current JSON number. + When this method returns, contains a double-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . @@ -1313,7 +1313,7 @@ On .NET Core, this method does not return `false` for values larger than - When this method returns, contains the GUID equivalent to the current JSON string. + When this method returns, contains the GUID equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. Attempts to represent the current JSON string as a . if the string can be represented as a ; otherwise, . @@ -1352,7 +1352,7 @@ This method does not create a Guid representation of values other than JSON stri - When the method returns, contains the 16-bit integer equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as an . if the number can be represented as an ; otherwise, . @@ -1391,7 +1391,7 @@ This method does not parse the contents of a JSON string value. - When this method returns, contains the 32-bit integer value equivalent to the current JSON number. + When this method returns, contains the 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as an . if the number can be represented as an ; otherwise, . @@ -1430,7 +1430,7 @@ This method does not parse the contents of a JSON string value. - When this method returns, contains the 64-bit integer value equivalent to the current JSON number. + When this method returns, contains the 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . @@ -1608,7 +1608,7 @@ If a property is defined multiple times for the same object, the method matches - When the method returns, contains the signed byte equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the signed byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as an . if the number can be represented as an ; otherwise, . @@ -1647,7 +1647,7 @@ This method does not parse the contents of a JSON string value. - When this method returns, contains the single-precision floating point value equivalent to the current JSON number. + When this method returns, contains the single-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . @@ -1694,7 +1694,7 @@ On .NET Core, this method does not return `false` for values larger than - When the method returns, contains the unsigned 16-bit integer equivalent of the current JSON number if the conversion succeeded. + When this method returns, contains the unsigned 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . @@ -1739,7 +1739,7 @@ This method does not parse the contents of a JSON string value. - When this method returns, contains unsigned 32-bit integer value equivalent to the current JSON number. + When this method returns, contains unsigned 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . @@ -1784,7 +1784,7 @@ This method does not parse the contents of a JSON string value. - When this method returns, contains unsigned 64-bit integer value equivalent to the current JSON number. + When this method returns, contains unsigned 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Attempts to represent the current JSON number as a . if the number can be represented as a ; otherwise, . diff --git a/xml/System.Text.Json/Utf8JsonReader.xml b/xml/System.Text.Json/Utf8JsonReader.xml index faca902a63f..c3e784064cd 100644 --- a/xml/System.Text.Json/Utf8JsonReader.xml +++ b/xml/System.Text.Json/Utf8JsonReader.xml @@ -1141,7 +1141,7 @@ For comments, this value points to before the first comment delimiter (that is, - When this method returns, contains the parsed value. + When this method returns, contains the byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1211,7 +1211,7 @@ For comments, this value points to before the first comment delimiter (that is, - When this method returns, contains the parsed value. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1250,7 +1250,7 @@ This method only creates a representation of JSON strings - When this method returns, contains the parsed value. + When this method returns, contains the date and time value equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1289,7 +1289,7 @@ This method only creates a representation of JSON s - When this method returns, contains the parsed value. + When this method returns, contains the decimal equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1320,7 +1320,7 @@ This method only creates a representation of JSON s - When this method returns, contains the parsed value. + When this method returns, contains a double-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1351,7 +1351,7 @@ This method only creates a representation of JSON s - When this method returns, contains the parsed value. + When this method returns, contains the GUID equivalent to the current JSON string if the conversion succeeded, or if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1390,7 +1390,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains the 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1421,7 +1421,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains the 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . @@ -1452,7 +1452,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains the 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . @@ -1489,7 +1489,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains the signed byte equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as an and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . @@ -1520,7 +1520,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains the single-precision floating point value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to an value; otherwise, . @@ -1557,7 +1557,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains the unsigned 16-bit integer value equivalent of the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1594,7 +1594,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains unsigned 32-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . @@ -1631,7 +1631,7 @@ This method only parses values with hyphens and without any s - When this method returns, contains the parsed value. + When this method returns, contains unsigned 64-bit integer value equivalent to the current JSON number if the conversion succeeded, or 0 if the conversion failed. Tries to parse the current JSON token value from the source as a and returns a value that indicates whether the operation succeeded. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, .