diff --git a/xml/System.Text.Json.Serialization/JsonAttribute.xml b/xml/System.Text.Json.Serialization/JsonAttribute.xml index f643669e4cb..5df72d53a54 100644 --- a/xml/System.Text.Json.Serialization/JsonAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonAttribute.xml @@ -14,7 +14,7 @@ - To be added. + Provides the base class for serialization attributes. To be added. @@ -31,9 +31,9 @@ - To be added. + Creates a new instance of the . To be added. - \ No newline at end of file + diff --git a/xml/System.Text.Json.Serialization/JsonExtensionDataAttribute.xml b/xml/System.Text.Json.Serialization/JsonExtensionDataAttribute.xml index 34d07f17653..9243ce481c7 100644 --- a/xml/System.Text.Json.Serialization/JsonExtensionDataAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonExtensionDataAttribute.xml @@ -19,8 +19,24 @@ - To be added. - To be added. + When placed on a property of type , any properties that do not have a matching member are added to that dictionary during deserialization and written during serialization. + + + , and `TValue` must be or . + +During deserialization, when using , a "null" JSON value is treated as a `null` object reference, and when using , a "null" is treated as a JsonElement with set to . + +During serialization, the name of the extension data property is not included in the JSON; the data contained within the extension data is serialized as properties of the JSON object. + +If there is more than one property on a type with this extension data attribute, or if the property itself is not of the correct type, an is thrown during the first serialization or deserialization of that type. + + ]]> + + @@ -36,9 +52,9 @@ - To be added. + Instantiates a new instance of the class. To be added. - \ No newline at end of file + diff --git a/xml/System.Text.Json.Serialization/JsonIgnoreAttribute.xml b/xml/System.Text.Json.Serialization/JsonIgnoreAttribute.xml index 15b06f3c265..0cf46dffb44 100644 --- a/xml/System.Text.Json.Serialization/JsonIgnoreAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonIgnoreAttribute.xml @@ -19,7 +19,7 @@ - To be added. + Prevents a property from being serialized or deserialized. To be added. @@ -36,7 +36,7 @@ - To be added. + Initializes a new instance of . To be added. diff --git a/xml/System.Text.Json.Serialization/JsonPropertyNameAttribute.xml b/xml/System.Text.Json.Serialization/JsonPropertyNameAttribute.xml index 7bdbff4ad91..581e9a5a1f9 100644 --- a/xml/System.Text.Json.Serialization/JsonPropertyNameAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonPropertyNameAttribute.xml @@ -19,7 +19,7 @@ - To be added. + Specifies the property name that is present in the JSON when serializing and deserializing. This overrides any naming policy specified by . To be added. @@ -39,8 +39,8 @@ - To be added. - To be added. + The name of the property. + Initializes a new instance of with the specified property name. To be added. @@ -60,10 +60,10 @@ System.String - To be added. - To be added. + Gets the name of the property. + The name of the property. To be added. - \ No newline at end of file + diff --git a/xml/System.Text.Json/JsonElement.xml b/xml/System.Text.Json/JsonElement.xml index 42fda0e619d..37874bc0eac 100644 --- a/xml/System.Text.Json/JsonElement.xml +++ b/xml/System.Text.Json/JsonElement.xml @@ -71,7 +71,7 @@ If this JsonElement is itself the output of a previous call to `Clone` or a valu Gets an enumerator to enumerate the values in the JSON array represented by this JsonElement. An enumerator to enumerate the values in the JSON array represented by this JsonElement. To be added. - This value's is not . + This value's is not . The parent has been disposed. @@ -95,7 +95,7 @@ If this JsonElement is itself the output of a previous call to `Clone` or a valu Gets an enumerator to enumerate the properties in the JSON object represented by this JsonElement. An enumerator to enumerate the properties in the JSON object represented by this JsonElement. To be added. - This value's is not . + This value's is not . The parent has been disposed. @@ -119,7 +119,7 @@ If this JsonElement is itself the output of a previous call to `Clone` or a valu Gets the number of values contained within the current array value. The number of values contained within the current array value. To be added. - This value's is not . + This value's is not . The parent has been disposed. @@ -149,7 +149,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is neither nor . + This value's is neither nor . The parent has been disposed. @@ -192,9 +192,22 @@ This method does not parse the contents of a JSON string value. - To be added. - To be added. - To be added. + Gets the value of the element as a byte array. + The value decoded as a byte array. + + + + + + This value's is not . + The value is not encoded as base 64 text and hence cannot be decoded to bytes. + The parent has been disposed. @@ -223,7 +236,7 @@ This method does not create a DateTime representation of values other than JSON ]]> - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -254,7 +267,7 @@ This method does not create a DateTimeOffset representation of values other than ]]> - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -282,10 +295,10 @@ This method does not create a DateTimeOffset representation of values other than - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -315,10 +328,10 @@ This method does not create a DateTimeOffset representation of values other than This method does not parse the contents of a JSON string value. On .NET Core, this method returns for values larger than , and it returns for values smaller than . - - ]]> + + ]]> - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -346,10 +359,10 @@ On .NET Core, this method returns - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -396,7 +409,7 @@ This method does not create a Guid representation of values other than JSON stri Gets the current JSON number as an . The current JSON number as an . To be added. - This value's is not . + This value's is not . The value cannot be represented as an . The parent has been disposed. @@ -424,10 +437,10 @@ This method does not create a Guid representation of values other than JSON stri - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -460,10 +473,10 @@ This method does not parse the contents of a JSON string value. Property name matching is performed as an ordinal, case-sensitive comparison. If a property is defined multiple times for the same object, the method matches the last such definition. - - ]]> + + ]]> - This value's is not . + This value's is not . No property was found with the requested name. The parent has been disposed. @@ -496,10 +509,10 @@ If a property is defined multiple times for the same object, the method matches Property name matching is performed as an ordinal, case-sensitive comparison. If a property is defined multiple times for the same object, the method matches the last such definition. - - ]]> + + ]]> - This value's is not . + This value's is not . No property was found with the requested name. The parent has been disposed. @@ -535,10 +548,9 @@ If a property is defined multiple times for the same object, the method matches ]]> - This value's is not . + This value's is not . No property was found with the requested name. - - is . + is . The parent has been disposed. @@ -617,10 +629,10 @@ If a property is defined multiple times for the same object, the method matches This method does not parse the contents of a JSON string value. On .NET Core, this method returns for values larger than and for values smaller than . - - ]]> + + ]]> - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -651,7 +663,7 @@ This method does not create a string representation of values other than JSON st ]]> - This value's is neither nor . + This value's is neither nor . The parent has been disposed. @@ -713,7 +725,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -749,7 +761,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is not . + This value's is not . The value cannot be represented as a . The parent has been disposed. @@ -777,9 +789,8 @@ This method does not parse the contents of a JSON string value. Gets the value at a specified index when the current value is an . To be added. To be added. - This value's is not . - - is not in the range [0, ()). + This value's is not . + is not in the range [0, ()). The parent has been disposed. @@ -814,8 +825,8 @@ For , , the value of is returned. For other types, the value of is returned. - - ]]> + + ]]> The parent has been disposed. @@ -864,10 +875,24 @@ For other types, the value of is - To be added. - To be added. - To be added. - To be added. + If the method succeeds, contains the decoded binary representation of the base 64 text. + Attempts to represent the current JSON string as a byte array, assuming that it is base 64-encoded. + + if the entire token value is encoded as valid base 64 text and can be successfully decoded to bytes. + otherwise. + + + + + + This value's is not . + The parent has been disposed. @@ -895,12 +920,12 @@ For other types, the value of is if the string can be represented as a , otherwise. - This value's is not . + This value's is not . The parent has been disposed. @@ -931,10 +956,10 @@ This method does not create a DateTime representation of values other than JSON - This value's is not . + This value's is not . The parent has been disposed. @@ -968,7 +993,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1001,10 +1026,10 @@ This method does not parse the contents of a JSON string value. This method does not parse the contents of a JSON string value. On .NET Core, this method does not return `false` for values larger than or smaller than . Instead, it returns This value's is not . + This value's is not . The parent has been disposed. @@ -1035,10 +1060,10 @@ On .NET Core, this method does not return `false` for values larger than - This value's is not . + This value's is not . The parent has been disposed. @@ -1097,7 +1122,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1131,7 +1156,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1166,10 +1191,10 @@ This method does not parse the contents of a JSON string value. Property name matching is performed as an ordinal, case-sensitive comparison. If a property is defined multiple times for the same object, the method matches the last such definition. - - ]]> + + ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1204,10 +1229,10 @@ If a property is defined multiple times for the same object, the method matches Property name matching is performed as an ordinal, case-sensitive comparison. If a property is defined multiple times for the same object, the method matches the last such definition. - - ]]> + + ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1242,12 +1267,11 @@ If a property is defined multiple times for the same object, the method matches Property name matching is performed as an ordinal, case-sensitive comparison. If a property is defined multiple times for the same object, the method matches the last such definition. - - ]]> + + ]]> - This value's is not . - - is . + This value's is not . + is . The parent has been disposed. @@ -1310,10 +1334,10 @@ If a property is defined multiple times for the same object, the method matches This method does not parse the contents of a JSON string value. On .NET Core, this method does not return `false` for values larger than or smaller than ). Instead, it returns `false` and assigns or to the `value` argument. - - ]]> + + ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1382,7 +1406,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1421,7 +1445,7 @@ This method does not parse the contents of a JSON string value. ]]> - This value's is not . + This value's is not . The parent has been disposed. @@ -1650,4 +1674,4 @@ This method does not parse the contents of a JSON string value. - \ No newline at end of file + diff --git a/xml/System.Text.Json/JsonEncodedText.xml b/xml/System.Text.Json/JsonEncodedText.xml index 43d3804ca9b..5ed725e8704 100644 --- a/xml/System.Text.Json/JsonEncodedText.xml +++ b/xml/System.Text.Json/JsonEncodedText.xml @@ -23,8 +23,18 @@ - To be added. - To be added. + Provides methods to transform UTF-8 or UTF-16 encoded text into a form that is suitable for JSON. + + + + + @@ -46,10 +56,11 @@ - To be added. - To be added. - To be added. + The UTF-8 encoded value to be transformed as JSON encoded text. + Encodes a UTF-8 encoded byte span as a JSON string. + The JSON string. To be added. + is too large or contains invalid UTF-8 bytes. @@ -71,10 +82,11 @@ - To be added. - To be added. - To be added. + The value to be transformed as JSON encoded text. + Encodes a UTF-16 encoded character span as a JSON string. + The JSON string. To be added. + is too large or contains invalid UTF-16 characters. @@ -96,10 +108,12 @@ - To be added. - To be added. + The value to be transformed as JSON encoded text. + Encodes the string text value as a JSON string. To be added. To be added. + is . + is too large or contains invalid UTF-16 characters. @@ -118,8 +132,8 @@ System.ReadOnlySpan<System.Byte> - To be added. - To be added. + Gets the UTF-8 encoded representation of the pre-encoded JSON text. + The UTF-8 encoded representation of the pre-encoded JSON text. To be added. @@ -143,9 +157,19 @@ To be added. - To be added. - To be added. - To be added. + Determines whether this instance and a specified object, which must also be a instance, have the same value. + if the current instance and are equal; otherwise, . + + + + + @@ -171,9 +195,19 @@ To be added. - To be added. - To be added. - To be added. + Determines whether this instance and another specified instance have the same value. + if this instance and have the same value; otherwise, . + + + are treated as equal. + + ]]> + + @@ -193,9 +227,19 @@ - To be added. - To be added. - To be added. + Returns the hash code for this . + The hash code for this instance. + + + . + + ]]> + + @@ -215,10 +259,20 @@ - To be added. - To be added. - To be added. + Converts the value of this instance to a . + The underlying UTF-16 encoded string. + + + . + + ]]> + + - \ No newline at end of file + diff --git a/xml/System.Text.Json/JsonException.xml b/xml/System.Text.Json/JsonException.xml index 33876f11d62..71c64e03afe 100644 --- a/xml/System.Text.Json/JsonException.xml +++ b/xml/System.Text.Json/JsonException.xml @@ -14,7 +14,7 @@ - To be added. + Defines a custom exception object that is thrown when invalid JSON text is encountered, when the defined maximum depth is passed, or the JSON text is not compatible with the type of a property on an object. To be added. @@ -73,10 +73,11 @@ - To be added. - To be added. - To be added. + The serialized object data about the exception being thrown. + An object that contains contextual information about the source or destination. + Creates a new exception object with serialized data. To be added. + is . @@ -121,12 +122,22 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The context-specific error message. + The path where the invalid JSON was encountered. + The line number (starting at 0) at which the invalid JSON was encountered when deserializing. + The byte count within the current line (starting at 0) where the invalid JSON was encountered. + Creates a new exception object to relay error information to the user. + + + + + @@ -149,13 +160,23 @@ - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The context-specific error message. + The path where the invalid JSON was encountered. + The line number (starting at 0) at which the invalid JSON was encountered when deserializing. + The byte count (starting at 0) within the current line where the invalid JSON was encountered. + The exception that caused the current exception. + Creates a new exception object to relay error information to the user that includes a specified inner exception. + + + + + @@ -174,8 +195,8 @@ System.Nullable<System.Int64> - To be added. - To be added. + Gets the zero-based number of bytes read within the current line before the exception. + The zero-based number of bytes read within the current line before the exception. To be added. @@ -199,9 +220,9 @@ - To be added. - To be added. - To be added. + The serialized object data about the exception being thrown. + An object that contains contextual information about the source or destination. + Sets the with information about the exception. To be added. @@ -221,8 +242,8 @@ System.Nullable<System.Int64> - To be added. - To be added. + Gets the zero-based number of lines read before the exception. + The zero-based number of lines read before the exception. To be added. @@ -263,10 +284,10 @@ System.String - To be added. - To be added. + Gets The path within the JSON where the exception was encountered. + The path within the JSON where the exception was encountered. To be added. - \ No newline at end of file + diff --git a/xml/System.Text.Json/JsonReaderOptions.xml b/xml/System.Text.Json/JsonReaderOptions.xml index 4544c949f0e..292e96fb1a9 100644 --- a/xml/System.Text.Json/JsonReaderOptions.xml +++ b/xml/System.Text.Json/JsonReaderOptions.xml @@ -39,9 +39,19 @@ System.Boolean - Defines whether an extra comma at the end of a list of JSON values in an object or array is allowed (and ignored) within the JSON payload being read. By default, it's set to false, and a is thrown if a trailing comma is encountered. - To be added. - To be added. + Gets or sets a value that defines whether an extra comma at the end of a list of JSON values in an object or array is allowed (and ignored) within the JSON payload being read. + if an exra comma is allowed; otherwise, . + + + is thrown if a trailing comma is encountered. + + ]]> + + @@ -65,7 +75,7 @@ System.Text.Json.JsonCommentHandling - Gets or sets how the struct handles comments when reading through the JSON data. + Gets or sets a value that determines how the handles comments when reading through the JSON data. One of the enumeration values that indicates how comments are handled. if i ]]> + The property is being set to a value that is not a member of the enumeration. @@ -99,10 +110,21 @@ By default, the reader throws a if i System.Int32 - Gets or sets the maximum depth allowed when reading JSON, with the default (i.e. 0) indicating a max depth of 64. Reading past this depth will throw a . - To be added. - To be added. + Gets or sets the maximum depth allowed when reading JSON, with the default (that is, 0) indicating a maximum depth of 64. + The maximum depth allowed when reading JSON. + + + . + + ]]> + + + The maximum depth is being set to a negative value. - \ No newline at end of file + diff --git a/xml/System.Text.Json/JsonTokenType.xml b/xml/System.Text.Json/JsonTokenType.xml index 0a775042fc6..324dae20838 100644 --- a/xml/System.Text.Json/JsonTokenType.xml +++ b/xml/System.Text.Json/JsonTokenType.xml @@ -34,7 +34,7 @@ 6 - To be added. + The token type is a comment string. @@ -54,7 +54,7 @@ 4 - To be added. + The token type is the end of a JSON array. @@ -74,7 +74,7 @@ 2 - To be added. + The token type is the end of a JSON object. @@ -94,7 +94,7 @@ 10 - To be added. + The token type is the JSON literal false. @@ -114,7 +114,18 @@ 0 - To be added. + There is no value (as distinct from ). + + + . + + ]]> + + @@ -134,7 +145,7 @@ 11 - To be added. + The token type is the JSON literal null. @@ -154,7 +165,7 @@ 8 - To be added. + The token type is a JSON number. @@ -174,7 +185,7 @@ 5 - To be added. + The token type is a JSON property name. @@ -194,7 +205,7 @@ 3 - To be added. + The token type is the start of a JSON array. @@ -214,7 +225,7 @@ 1 - To be added. + The token type is the start of a JSON object. @@ -234,7 +245,7 @@ 7 - To be added. + The token type is a JSON string. @@ -254,8 +265,8 @@ 9 - To be added. + The token type is the JSON literal true. - \ No newline at end of file + diff --git a/xml/System.Text.Json/Utf8JsonReader.xml b/xml/System.Text.Json/Utf8JsonReader.xml index 5060b288acc..6fbd4bb3a07 100644 --- a/xml/System.Text.Json/Utf8JsonReader.xml +++ b/xml/System.Text.Json/Utf8JsonReader.xml @@ -21,7 +21,8 @@ Provides a high-performance API for forward-only, read-only access to the UTF-8 encoded JSON text. - + - To be added. - To be added. - To be added. - To be added. - To be added. + The UTF-8 encoded JSON text to process. + + when the input sequence contains the entire data to process. only if it's known that the input span contains partial data with more data to follow. + If this is the first call to the constructor, pass in a default state. Otherwise, capture the state from the previous instance of the and pass that back. + Initializes a new instance of the class. + + + . + + ]]> + @@ -130,7 +142,8 @@ To be able to set max depth while reading OR allow skipping comments, create an A struct that contains the reader state. On the first call to the constructor, it should reflect a default state; otherwise, it should capture the state from the previous instance instance of the and pass that back. Initializes a new instance of the class. - + Gets the depth of the current token. The depth of the current token. - + Gets the current snapshot of the state that must be captured by the caller and passed back in to the constructor with more data. To be added. - + - To be added. - To be added. + Parses the current JSON token value from the source and decodes the base 64 encoded JSON string as a byte array. + The byte array that represents the current JSON token value. To be added. + The type of the JSON token is not a . + The value is not encoded as base 64 text and hence cannot be decoded to bytes. @@ -307,9 +324,10 @@ in more data asynchronously before continuing with a new instance of the - To be added. - To be added. + Parses the current JSON token value from the source as a comment, transcoded it as a . + The comment that represents the current JSON token value. To be added. + The JSON token is not a comment. @@ -380,7 +398,7 @@ in more data asynchronously before continuing with a new instance of the Reads the next JSON token value from the source and parses it to a . The UTF-8 encoded token value parsed to a . - Reads the next JSON token value from the source and parses it to a . The UTF-8 encoded token value parsed to a . - Reads the next JSON token value from the source and parses it to an . The UTF-8 encoded token value parsed to an . - Reads the next JSON token value from the source and parses it to an . The UTF-8 encoded token value parsed to an . - Reads the next JSON token value from the source and parses it to a . The UTF-8 encoded token value parsed to a . - if should be used to get the token value. if should be used instead. - `, this always returns `false`. For i System.Boolean - To be added. - To be added. + Gets the mode of this instance of the which indicates whether all the JSON data was provided or there is more data to come. + if the reader was constructed with the input span or sequence containing the entire JSON data to process. if the reader was constructed with an input span or sequence that may contain partial JSON data with more data to follow. To be added. @@ -853,8 +871,28 @@ The current depth exceeds the recursive limit set by the maximum depth. - To be added. - To be added. + Skips the children of the current JSON token. + + + is , the reader first moves to the property value. + +When (originally, or after advancing) is or , the reader advances to the matching or . + +For all other token types, the reader does not move. After the next call to , the reader will be at the next value (when in an array), the next property name (when in an object), or the end array/object token. + + ]]> + + + The reader was given partial data with more data to follow (that is, is ). + An invalid JSON token was encountered while skipping, according to the JSON RFC. + +- or - + +The current depth exceeds the recursive limit set by the maximum depth. @@ -878,9 +916,21 @@ The current depth exceeds the recursive limit set by the maximum depth.System.Int64 - To be added. - To be added. - To be added. + Gets the index that the last processed JSON token starts at (within the given UTF-8 encoded input text), skipping any white space. + The starting index of the last processed JSON token within the given UTF-8 encoded input text. + + + + + @@ -948,10 +998,11 @@ The current depth exceeds the recursive limit set by the maximum depth. - To be added. - To be added. - To be added. + If the method succeeds, contains the decoded binary representation of the base 64 text. + Tries to parse the current JSON token value from the source and decodes the base 64 encoded JSON string as a byte array. + if the entire token value is encoded as valid base 64 text and can be successfully decoded to bytes; otherwise. To be added. + The JSON token is not a . @@ -1088,7 +1139,9 @@ The current depth exceeds the recursive limit set by the maximum depth. if the entire UTF-8 encoded token value can be successfully parsed to a value; otherwise, . - values with hyphens and without any surrounding decorations. @@ -1349,9 +1402,30 @@ This method only parses values with hyphens and without any s - To be added. - To be added. - To be added. + Tries to skip the children of the current JSON token. + + if there was enough data for the children to be skipped successfully; otherwise, . + + + is , the reader first moves to the property value. + +When (originally, or after advancing) is or , the reader advances to the matching or . + +For all other token types, the reader does not move. After the next call to , the reader will be at the next value (when in an array), the next property name (when in an object), or the end array/object token. + + ]]> + + An invalid JSON token was encountered while skipping, according to the JSON RFC. + +- or - + +The current depth exceeds the recursive limit set by the maximum depth. @@ -1380,7 +1454,8 @@ This method only parses values with hyphens and without any s Otherwise, contains the token value. To be added. - + contains the token value. To be added. - Provides a high-performance API for forward-only, non-cached writing of UTF-8 encoded JSON text. - Defines the customized behavior of the By default, it writes minimized JSON (with no extra whitespace) and validates that the JSON being written is structurally valid according to the JSON RFC. Constructs a new instance with a specified . To be added. - - is . + is . @@ -84,8 +83,7 @@ To be able to format the output with indentation and white space OR to skip vali Defines the customized behavior of the By default, it writes minimized JSON (with no extra whitespace) and validates that the JSON being written is structurally valid according to the JSON RFC. Constructs a new instance with a specified . To be added. - - is . + is . @@ -157,7 +155,7 @@ In the case of a , this property indicates how much data Gets the depth of the current token. The depth of the current token. - instance cannot be reused after disposing. - - ]]> + + ]]> @@ -375,8 +373,7 @@ The will continue to use the original wri ]]> - - is . + is . This instance has been disposed. @@ -408,8 +405,7 @@ The will continue to use the original wri ]]> - - is . + is . This instance has been disposed. @@ -433,10 +429,22 @@ The will continue to use the original wri - To be added. - To be added. - To be added. - To be added. + The UTF-8 encoded name of the property to write. + The binary data to be written as a base 64 encoded JSON string as part of the name/value pair. + Writes the property name and raw bytes value (as a base 64 encoded JSON string) as part of a name/value pair of a JSON object. + + + + + + The specified property name is too large. + Validation is enabled, and this method would result in writing invalid JSON. @@ -459,10 +467,22 @@ The will continue to use the original wri - To be added. - To be added. - To be added. - To be added. + The property name of the JSON object to be transcoded and written as UTF-8. + The binary data to be written as a base 64 encoded JSON string as part of the name/value pair. + Writes the property name and raw bytes value (as a base 64 encoded JSON string) as part of a name/value pair of a JSON object. + + + + + + The specified property name is too large. + Validation is enabled, and this method would result in writing invalid JSON. @@ -485,10 +505,23 @@ The will continue to use the original wri - To be added. - To be added. - To be added. - To be added. + The property name of the JSON object to be transcoded and written as UTF-8. + The binary data to be written as a base 64 encoded JSON string as part of the name/value pair. + Writes the property name and raw bytes value (as a Base64 encoded JSON string) as part of a name/value pair of a JSON object. + + + + + + + when the specified property name is too large. + Validation is enabled, and this method would result in writing invalid JSON. @@ -511,10 +544,21 @@ The will continue to use the original wri - To be added. - To be added. - To be added. - To be added. + The JSON-encoded name of the property to write. + The binary data to be written as a base 64 encoded JSON string as part of the name/value pair. + Writes the pre-encoded property name and raw bytes value (as a base 64 encoded JSON string) as part of a name/value pair of a JSON object. + + + was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -536,9 +580,21 @@ The will continue to use the original wri - To be added. - To be added. - To be added. + The binary data to be written as a base 64 encoded JSON string element of a JSON array. + Writes the raw bytes value as base 64 encoded JSON string as an element of a JSON array. + + + + + + The specified value is too large. + Validation is enabled, and this method would result in writing invalid JSON. @@ -562,8 +618,8 @@ The will continue to use the original wri The UTF-8 encoded property name of the JSON object to be written. - The value to be written as a JSON literal "true" or "false" as part of the name/value pair. - Writes a property name specified as a read-only span of bytes and a value (as a JSON literal "true" or "false") as part of a name/value pair of a JSON object. + The value to be written as a JSON literal true or false as part of the name/value pair. + Writes a property name specified as a read-only span of bytes and a value (as a JSON literal true or false) as part of a name/value pair of a JSON object. The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8. - The value to be written as a JSON literal "true" or "false" as part of the name/value pair. - Writes a property name specified as a read-only character span and a value (as a JSON literal "true" or "false") as part of a name/value pair of a JSON object. + The value to be written as a JSON literal true or false as part of the name/value pair. + Writes a property name specified as a read-only character span and a value (as a JSON literal true or false) as part of a name/value pair of a JSON object. The specified property name is too large. @@ -630,13 +686,13 @@ The property name is escaped before writing. The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8. - The value to be written as a JSON literal "true" or "false" as part of the name/value pair. - Writes a property name specified as a string and a value (as a JSON literal "true" or "false") as part of a name/value pair of a JSON object. + The value to be written as a JSON literal true or false as part of the name/value pair. + Writes a property name specified as a string and a value (as a JSON literal true or false) as part of a name/value pair of a JSON object. The specified property name is too large. @@ -663,10 +719,21 @@ The property name is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON literal true or false as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON literal true or false) as part of a name/value pair of a JSON object. + + + was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -688,8 +755,8 @@ The property name is escaped before writing. - The value to be written as a JSON literal "true" or "false" as an element of a JSON array. - Writes a value (as a JSON literal "true" or "false") as an element of a JSON array. + The value to be written as a JSON literal true or false as an element of a JSON array. + Writes a value (as a JSON literal true or false) as an element of a JSON array. To be added. Validation is enabled, and the operation would result in writing invalid JSON. @@ -719,14 +786,14 @@ The property name is escaped before writing. The specified value is too large. -or- - contains a comment delimiter (i.e. */). + contains a comment delimiter (that is, */). @@ -754,14 +821,14 @@ The comment value is not escaped before writing. The specified value is too large OR. -or- - contains a comment delimiter (i.e. */). + contains a comment delimiter (that is, */). @@ -789,14 +856,14 @@ The comment value is not escaped before writing. The specified value is too large. -or- - contains a comment delimiter (i.e. */). + contains a comment delimiter (that is, */). @@ -863,12 +930,12 @@ The comment value is not escaped before writing. The UTF-8 encoded property name of the JSON object to be written. - Writes a property name specified as a read-only span of bytes and the JSON literal "null" as part of a name/value pair of a JSON object. + Writes a property name specified as a read-only span of bytes and the JSON literal null as part of a name/value pair of a JSON object. The specified property name is too large. @@ -895,12 +962,12 @@ The property name is escaped before writing. The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8. - Writes a property name specified as a read-only character span and the JSON literal "null" as part of a name/value pair of a JSON object. + Writes a property name specified as a read-only character span and the JSON literal null as part of a name/value pair of a JSON object. The specified property name is too large. @@ -927,12 +994,12 @@ The property name is escaped before writing. The UTF-16 encoded property name of the JSON object to be transcoded and written as UTF-8. - Writes a property name specified as a string and the JSON literal "null" as part of a name/value pair of a JSON object. + Writes a property name specified as a string and the JSON literal null as part of a name/value pair of a JSON object. The specified property name is too large. @@ -958,9 +1025,20 @@ The property name is escaped before writing. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + Writes the pre-encoded property name and the JSON literal null as part of a name/value pair of a JSON object. + + + was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -980,7 +1058,7 @@ The property name is escaped before writing. - Writes the JSON literal "null" as an element of a JSON array. + Writes the JSON literal null as an element of a JSON array. To be added. Validation is enabled, and the operation would result in writing invalid JSON. @@ -1011,7 +1089,9 @@ The property name is escaped before writing. using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1045,7 +1125,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1079,7 +1161,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1113,7 +1197,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1147,7 +1233,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1186,7 +1274,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1225,7 +1315,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1259,7 +1351,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1293,7 +1387,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1327,7 +1423,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1361,7 +1459,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1395,7 +1495,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1434,7 +1536,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1473,7 +1577,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1507,7 +1613,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1541,7 +1649,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1575,7 +1685,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1609,7 +1721,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1643,7 +1757,9 @@ Writes the using the default using the default (i.e. 'G'). The property name is escaped before writing. +Writes the using the default (that is, 'G'). + +The property name is escaped before writing. ]]> @@ -1682,7 +1798,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1721,7 +1839,9 @@ Writes the using the default using the default (i.e. 'G'), for example: 32767. The property name is escaped before writing. +Writes the using the default (that is, 'G'); for example, 32767. + +The property name is escaped before writing. ]]> @@ -1749,10 +1869,23 @@ Writes the using the default - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON number as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + + using the default (that is, 'G'). + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -1775,10 +1908,23 @@ Writes the using the default - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON number as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + + using the default (that is, 'G'). + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -1801,10 +1947,23 @@ Writes the using the default - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON number as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + + using the default (that is, 'G'); for example, 32767. + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -1827,10 +1986,23 @@ Writes the using the default - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON number as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + + using the default (this is, 'G'); for example, 32767. + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -1853,10 +2025,23 @@ Writes the using the default - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON number as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + + using the default (that is, 'G'). + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -1884,10 +2069,23 @@ Writes the using the default - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON number as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + + using the default (that is, 'G'); for example, 32767. + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -1915,10 +2113,23 @@ Writes the using the default - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON number as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + + using the default (that is, 'G'); for example, 32767. + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and this method would result in writing invalid JSON. @@ -2397,9 +2608,24 @@ Validation is enabled, and this write operation would produce invalid JSON. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON array to be transcoded and written as UTF-8. + Writes the beginning of a JSON array with a pre-encoded property name as the key. + + + was created. + + ]]> + + + The depth of the JSON has exceeded the maximum depth of 1000. + +- or - + +Validation is enabled, and this method would result in writing invalid JSON. @@ -2555,9 +2781,24 @@ Validation is enabled, and this write operation would produce invalid JSON. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + Writes the beginning of a JSON object with a pre-encoded property name as the key. + + + was created. + + ]]> + + + The depth of the JSON has exceeded the maximum depth of 1000. + +- or - + +Validation is enabled, and this method would result in writing invalid JSON. @@ -2620,7 +2861,7 @@ Writes the using the round-trippable ('O') using the round-trippable ('O') , for example: 2017-06-12T05:30:45.7680000-07:00. The property name is escaped before writing. +Writes the using the round-trippable ('O') ; for example, 2017-06-12T05:30:45.7680000-07:00. The property name is escaped before writing. ]]> @@ -2654,7 +2895,7 @@ Writes the using the round-trippable ('O') using the default (i.e. 'D'), as the form: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn. The property name is escaped before writing. +Writes the using the default (that is, 'D'), in the form: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn. The property name is escaped before writing. ]]> @@ -2784,10 +3025,24 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The UTF-8 encoded property name of the JSON object to be written. + The JSON encoded value to be written as a UTF-8 transcoded JSON string as part of the name/value pair. + Writes the UTF-8 property name and pre-encoded value (as a JSON string) as part of a name/value pair of a JSON object. + + + was created. + +The property name is escaped before writing. + + ]]> + + + The specified property name is too large. + Validation is enabled, and this method would result in writing invalid JSON. @@ -2816,7 +3071,7 @@ The property name and value is escaped before writing. using the round-trippable ('O') , for example: 2017-06-12T05:30:45.7680000. The property name is escaped before writing. +Writes the using the round-trippable ('O') ; for example, 2017-06-12T05:30:45.7680000. The property name is escaped before writing. ]]> @@ -2850,7 +3105,7 @@ Writes the using the round-trippable ('O') using the round-trippable ('O') , for example: 2017-06-12T05:30:45.7680000-07:00. The property name is escaped before writing. +Writes the using the round-trippable ('O') ; for example, 2017-06-12T05:30:45.7680000-07:00. The property name is escaped before writing. ]]> @@ -2884,7 +3139,7 @@ Writes the using the round-trippable ('O') using the default (i.e. 'D'), as the form: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn. The property name is escaped before writing. +Writes the using the default (that is, 'D'), in the form: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn. The property name is escaped before writing. ]]> @@ -3014,10 +3269,24 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The property name of the JSON object to be transcoded and written as UTF-8. + The JSON encoded value to be written as a UTF-8 transcoded JSON string as part of the name/value pair. + Writes the property name and pre-encoded value (as a JSON string) as part of a name/value pair of a JSON object. + + + was created. + +The property name is escaped before writing. + + ]]> + + + The specified property name is too large. + Validation is enabled, and the write operation would produce invalid JSON. @@ -3046,7 +3315,7 @@ The property name and value is escaped before writing. using the round-trippable ('O') , for example: 2017-06-12T05:30:45.7680000. The property name is escaped before writing. +Writes the using the round-trippable ('O') ; for example, 2017-06-12T05:30:45.7680000. The property name is escaped before writing. ]]> @@ -3080,7 +3349,7 @@ Writes the using the round-trippable ('O') using the round-trippable ('O') , for example: 2017-06-12T05:30:45.7680000-07:00. The property name is escaped before writing. +Writes the using the round-trippable ('O') ; for example, 2017-06-12T05:30:45.7680000-07:00. The property name is escaped before writing. ]]> @@ -3114,7 +3383,7 @@ Writes the using the round-trippable ('O') using the default (i.e. 'D'), as the form: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn. The property name is escaped before writing. +Writes the using the default (that is, 'D'), in the form: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn. The property name is escaped before writing. ]]> @@ -3244,10 +3513,24 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The property name of the JSON object to be transcoded and written as UTF-8. + The JSON encoded value to be written as a UTF-8 transcoded JSON string as part of the name/value pair. + Writes the property name and pre-encoded value (as a JSON string) as part of a name/value pair of a JSON object. + + + was created. + +The property name is escaped before writing. + + ]]> + + + The specified property name is too large. + Validation is enabled, and the write operation would produce invalid JSON. @@ -3270,10 +3553,23 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON string as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON string) as part of a name/value pair of a JSON object. + + + using the round-trippable ('O') ; for example, 2017-06-12T05:30:45.7680000. + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and the write operation would produce invalid JSON. @@ -3296,10 +3592,23 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON string as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON string) as part of a name/value pair of a JSON object. + + + using the round-trippable ('O') ; for example, 2017-06-12T05:30:45.7680000-07:00. + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and the write operation would produce invalid JSON. @@ -3322,10 +3631,23 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a JSON string as part of the name/value pair. + Writes the pre-encoded property name and value (as a JSON string) as part of a name/value pair of a JSON object. + + + using the default (that is, 'D'), in the form: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn. + +The property name should already be escaped when the instance of was created. + + ]]> + + + Validation is enabled, and the write operation would produce invalid JSON. @@ -3348,10 +3670,24 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The UTF-8 encoded value to be written as a JSON string as part of the name/value pair. + Writes the pre-encoded property name and UTF-8 text value (as a JSON string) as part of a name/value pair of a JSON object. + + + was created. + +The value is escaped before writing. + + ]]> + + + The specified value is too large. + Validation is enabled, and the write operation would produce invalid JSON. @@ -3374,10 +3710,24 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a UTF-8 transcoded JSON string as part of the name/value pair. + Writes the pre-encoded property name and text value (as a JSON string) as part of a name/value pair of a JSON object. + + + was created. + +The value is escaped before writing. + + ]]> + + + The specified value is too large. + Validation is enabled, and the write operation would produce invalid JSON. @@ -3400,10 +3750,24 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The value to be written as a UTF-8 transcoded JSON string as part of the name/value pair. + Writes the pre-encoded property name and string text value (as a JSON string) as part of a name/value pair of a JSON object. + + + was created. + +The value is escaped before writing. + + ]]> + + + The specified value is too large. + Validation is enabled, and the write operation would produce invalid JSON. @@ -3426,10 +3790,21 @@ The property name and value is escaped before writing. - To be added. - To be added. - To be added. - To be added. + The JSON encoded property name of the JSON object to be transcoded and written as UTF-8. + The JSON encoded value to be written as a UTF-8 transcoded JSON string as part of the name/value pair. + Writes the pre-encoded property name and pre-encoded value (as a JSON string) as part of a name/value pair of a JSON object. + + + was created. + + ]]> + + + Validation is enabled, and the write operation would produce invalid JSON. @@ -3640,10 +4015,21 @@ The value is escaped before writing. - To be added. - To be added. - To be added. + The JSON encoded value to be written as a UTF-8 transcoded JSON string element of a JSON array. + Writes the pre-encoded text value (as a JSON string) as an element of a JSON array. + + + was created. + + ]]> + + + Validation is enabled, and the write operation would produce invalid JSON. - \ No newline at end of file +