diff --git a/ArchiSteamFarm/ArchiSteamFarm.csproj b/ArchiSteamFarm/ArchiSteamFarm.csproj index 77720c3e5..cfbaed3da 100644 --- a/ArchiSteamFarm/ArchiSteamFarm.csproj +++ b/ArchiSteamFarm/ArchiSteamFarm.csproj @@ -80,7 +80,7 @@ True - ..\packages\Newtonsoft.Json.9.0.2-beta1\lib\net45\Newtonsoft.Json.dll + ..\packages\Newtonsoft.Json.9.0.2-beta2\lib\net45\Newtonsoft.Json.dll True diff --git a/ArchiSteamFarm/packages.config b/ArchiSteamFarm/packages.config index 9e3556da9..258e54abe 100644 --- a/ArchiSteamFarm/packages.config +++ b/ArchiSteamFarm/packages.config @@ -3,7 +3,7 @@ - + diff --git a/ConfigGenerator/ConfigGenerator.csproj b/ConfigGenerator/ConfigGenerator.csproj index d930c243f..9a6794d4c 100644 --- a/ConfigGenerator/ConfigGenerator.csproj +++ b/ConfigGenerator/ConfigGenerator.csproj @@ -47,7 +47,7 @@ - ..\packages\Newtonsoft.Json.9.0.2-beta1\lib\net45\Newtonsoft.Json.dll + ..\packages\Newtonsoft.Json.9.0.2-beta2\lib\net45\Newtonsoft.Json.dll True diff --git a/ConfigGenerator/packages.config b/ConfigGenerator/packages.config index b8cf0bf7c..dc0975c4a 100644 --- a/ConfigGenerator/packages.config +++ b/ConfigGenerator/packages.config @@ -2,6 +2,6 @@ - + \ No newline at end of file diff --git a/GUI/GUI.csproj b/GUI/GUI.csproj index 333128540..10fd1dbf8 100644 --- a/GUI/GUI.csproj +++ b/GUI/GUI.csproj @@ -49,7 +49,7 @@ True - ..\packages\Newtonsoft.Json.9.0.2-beta1\lib\net45\Newtonsoft.Json.dll + ..\packages\Newtonsoft.Json.9.0.2-beta2\lib\net45\Newtonsoft.Json.dll True diff --git a/GUI/packages.config b/GUI/packages.config index f13a2da05..df53c2330 100644 --- a/GUI/packages.config +++ b/GUI/packages.config @@ -3,7 +3,7 @@ - + diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/Newtonsoft.Json.9.0.2-beta1.nupkg b/packages/Newtonsoft.Json.9.0.2-beta1/Newtonsoft.Json.9.0.2-beta1.nupkg deleted file mode 100644 index 2a96df9f4..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/Newtonsoft.Json.9.0.2-beta1.nupkg and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net20/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/net20/Newtonsoft.Json.dll deleted file mode 100644 index d45889895..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net20/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net35/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/net35/Newtonsoft.Json.dll deleted file mode 100644 index fb244ab5b..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net35/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net40/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/net40/Newtonsoft.Json.dll deleted file mode 100644 index 84478947e..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net40/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net45/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/net45/Newtonsoft.Json.dll deleted file mode 100644 index 5523f5c39..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net45/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.0/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.0/Newtonsoft.Json.dll deleted file mode 100644 index f4293769b..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.0/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.1/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.1/Newtonsoft.Json.dll deleted file mode 100644 index e31834b55..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.1/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.dll deleted file mode 100644 index ef9dbae7e..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.dll deleted file mode 100644 index a3e54242f..000000000 Binary files a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.dll and /dev/null differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/Newtonsoft.Json.9.0.2-beta2.nupkg b/packages/Newtonsoft.Json.9.0.2-beta2/Newtonsoft.Json.9.0.2-beta2.nupkg new file mode 100644 index 000000000..3fe0b8294 Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/Newtonsoft.Json.9.0.2-beta2.nupkg differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/net20/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net20/Newtonsoft.Json.dll new file mode 100644 index 000000000..b9f365535 Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net20/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net20/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net20/Newtonsoft.Json.xml similarity index 91% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/net20/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/net20/Newtonsoft.Json.xml index cc1bdd090..945133b63 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net20/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net20/Newtonsoft.Json.xml @@ -23,12 +23,12 @@ - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. @@ -52,19 +52,19 @@ Initializes a new instance of the class. - The stream. + The containing the BSON data to read. Initializes a new instance of the class. - The reader. + The containing the BSON data to read. Initializes a new instance of the class. - The stream. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. @@ -72,13 +72,13 @@ Initializes a new instance of the class. - The reader. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -86,12 +86,13 @@ - Changes the to Closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. @@ -105,17 +106,17 @@ Initializes a new instance of the class. - The stream. + The to write to. Initializes a new instance of the class. - The writer. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. @@ -126,7 +127,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -166,7 +167,9 @@ - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -320,7 +323,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -394,7 +397,7 @@ - Create a custom object + Creates a custom object. The object type to convert. @@ -639,7 +642,7 @@ - Converts a to and from a string (e.g. "1.2.3.4"). + Converts a to and from a string (e.g. "1.2.3.4"). @@ -671,7 +674,7 @@ - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). @@ -712,7 +715,7 @@ - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). @@ -740,16 +743,16 @@ - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. - The name of the deserialize root element. + The name of the deserialized root element. Gets or sets a flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - true if the array attibute is written to the XML; otherwise, false. + true if the array attribute is written to the XML; otherwise, false. @@ -777,7 +780,7 @@ - Checks if the attributeName is a namespace attribute. + Checks if the is a namespace attribute. Attribute name to test. The attribute name prefix if it has one, otherwise an empty string. @@ -799,17 +802,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -819,7 +822,7 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -856,18 +859,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -908,7 +911,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -963,7 +966,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -971,8 +974,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -1003,7 +1006,7 @@ - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -1066,7 +1069,7 @@ - Gets or sets how how null value properties are merged. + Gets or sets how null value properties are merged. How null value properties are merged. @@ -1129,23 +1132,20 @@ The value of a property for a given component. - The component with the property for which to retrieve the value. - + The component with the property for which to retrieve the value. When overridden in a derived class, resets the value for this property of the component to the default value. - The component with the property value that is to be reset to the default value. - + The component with the property value that is to be reset to the default value. When overridden in a derived class, sets the value of the component to a different value. - The component with the property value that is to be set. - The new value. - + The component with the property value that is to be set. + The new value. @@ -1161,7 +1161,10 @@ When overridden in a derived class, gets the type of the component this property is bound to. - A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. + A that represents the type of component this property is bound to. + When the or + + methods are invoked, the object specified might be an instance of this type. @@ -1217,11 +1220,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -1246,7 +1249,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -1442,18 +1445,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -1534,13 +1537,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -1556,13 +1559,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -1588,13 +1591,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -1609,23 +1612,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -1705,22 +1700,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -1736,7 +1731,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -1746,11 +1741,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -1775,7 +1770,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -1789,7 +1784,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -1797,7 +1792,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -1850,7 +1845,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -1858,7 +1853,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -1870,106 +1865,6 @@ Name of the property. - - - Returns the properties for this instance of a component. - - - A that represents the properties for this component instance. - - - - - Returns the properties for this instance of a component using the attribute array as a filter. - - An array of type that is used as a filter. - - A that represents the filtered properties for this component instance. - - - - - Returns a collection of custom attributes for this instance of a component. - - - An containing the attributes for this object. - - - - - Returns the class name of this instance of a component. - - - The class name of the object, or null if the class does not have a name. - - - - - Returns the name of this instance of a component. - - - The name of the object, or null if the object does not have a name. - - - - - Returns a type converter for this instance of a component. - - - A that is the converter for this object, or null if there is no for this object. - - - - - Returns the default event for this instance of a component. - - - An that represents the default event for this object, or null if this object does not have events. - - - - - Returns the default property for this instance of a component. - - - A that represents the default property for this object, or null if this object does not have properties. - - - - - Returns an editor of the specified type for this instance of a component. - - A that represents the editor for this object. - - An of the specified type that is the editor for this object, or null if the editor cannot be found. - - - - - Returns the events for this instance of a component using the specified attribute array as a filter. - - An array of type that is used as a filter. - - An that represents the filtered events for this component instance. - - - - - Returns the events for this instance of a component. - - - An that represents the events for this component instance. - - - - - Returns an object that contains the property described by the specified property descriptor. - - A that represents the property whose owner is to be found. - - An that represents the owner of the specified property. - - Represents a JSON array. @@ -2026,7 +1921,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -2045,7 +1940,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -2056,7 +1951,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -2064,7 +1959,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -2087,84 +1982,81 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. @@ -2184,7 +2076,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2207,9 +2099,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -2224,13 +2116,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -2263,7 +2159,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -2285,7 +2181,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -2577,8 +2473,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -2590,42 +2486,42 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2674,56 +2570,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2737,14 +2633,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2800,7 +2696,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2814,7 +2710,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2842,7 +2738,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -2856,42 +2752,42 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -2919,7 +2815,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -2933,14 +2829,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -2954,28 +2850,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3038,7 +2934,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3052,23 +2948,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -3076,25 +2972,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -3102,7 +2998,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -3112,9 +3008,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3125,9 +3021,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3145,18 +3041,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3165,9 +3061,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3179,7 +3075,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -3198,7 +3094,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -3208,7 +3104,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -3241,7 +3137,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -3320,18 +3216,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -3569,7 +3465,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -3588,9 +3484,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -3653,7 +3546,7 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. @@ -3693,6 +3586,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -3725,8 +3633,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -3749,7 +3657,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -3757,7 +3665,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -3789,8 +3697,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -3846,8 +3754,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -3891,6 +3799,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -3903,9 +3817,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -3935,7 +3856,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -3943,7 +3864,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -3963,6 +3884,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -3987,7 +3923,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -4048,7 +3984,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -4174,6 +4110,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -4213,8 +4156,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -4302,7 +4245,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -4496,7 +4439,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -4554,9 +4497,9 @@ - Gets or sets the ISerializable object constructor. + Gets or sets the object constructor. - The ISerializable object constructor. + The object constructor. @@ -4636,7 +4579,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -4722,9 +4665,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -4766,13 +4709,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -4803,7 +4746,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -4828,11 +4771,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -4883,7 +4826,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -4894,8 +4837,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -4927,6 +4870,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -4946,11 +4895,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -5015,12 +4964,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. @@ -5268,13 +5217,13 @@ - Returns an that represents the total number + Returns a that represents the total number of elements in a sequence. - Returns an that represents how many elements + Returns a that represents how many elements in a sequence satisfy a condition. @@ -5650,48 +5599,48 @@ - Computes the sum of a sequence of nullable values. + Computes the sum of a sequence of values. - Computes the sum of a sequence of nullable + Computes the sum of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of nullable values. + Computes the average of a sequence of values. - Computes the average of a sequence of nullable values + Computes the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the sum of a sequence of values. + Computes the sum of a sequence of nullable values. - Computes the sum of a sequence of + Computes the sum of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of values. + Computes the average of a sequence of nullable values. - Computes the average of a sequence of values + Computes the average of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. @@ -5722,48 +5671,48 @@ - Computes the sum of a sequence of nullable values. + Computes the sum of a sequence of values. - Computes the sum of a sequence of nullable + Computes the sum of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of nullable values. + Computes the average of a sequence of values. - Computes the average of a sequence of nullable values + Computes the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the sum of a sequence of values. + Computes the sum of a sequence of nullable values. - Computes the sum of a sequence of + Computes the sum of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of values. + Computes the average of a sequence of nullable values. - Computes the average of a sequence of values + Computes the average of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. @@ -5799,43 +5748,43 @@ - Computes the sum of a sequence of nullable + Computes the sum of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of nullable values. + Computes the average of a sequence of values. - Computes the average of a sequence of nullable values + Computes the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the sum of a sequence of values. + Computes the sum of a sequence of nullable values. - Computes the sum of a sequence of + Computes the sum of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of values. + Computes the average of a sequence of nullable values. - Computes the average of a sequence of values + Computes the average of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. @@ -5866,48 +5815,48 @@ - Computes the sum of a sequence of nullable values. + Computes the sum of a sequence of values. - Computes the sum of a sequence of nullable + Computes the sum of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of nullable values. + Computes the average of a sequence of values. - Computes the average of a sequence of nullable values + Computes the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the sum of a sequence of values. + Computes the sum of a sequence of nullable values. - Computes the sum of a sequence of + Computes the sum of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of values. + Computes the average of a sequence of nullable values. - Computes the average of a sequence of values + Computes the average of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. @@ -5938,48 +5887,48 @@ - Computes the sum of a sequence of nullable values. + Computes the sum of a sequence of values. - Computes the sum of a sequence of nullable + Computes the sum of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of nullable values. + Computes the average of a sequence of values. - Computes the average of a sequence of nullable values + Computes the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence. - Computes the sum of a sequence of values. + Computes the sum of a sequence of nullable values. - Computes the sum of a sequence of + Computes the sum of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. - Computes the average of a sequence of values. + Computes the average of a sequence of nullable values. - Computes the average of a sequence of values + Computes the average of a sequence of nullable values that are obtained by invoking a transform function on each element of the input sequence. @@ -6132,13 +6081,13 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -6151,21 +6100,21 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -6241,7 +6190,7 @@ - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. @@ -6276,7 +6225,7 @@ Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . @@ -6312,20 +6261,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -6345,7 +6294,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -6386,13 +6335,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -6403,13 +6354,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -6469,7 +6422,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -6483,7 +6436,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -6499,8 +6452,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -6514,7 +6467,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -6559,7 +6512,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -6583,7 +6536,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -6605,8 +6558,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -6691,7 +6644,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -6706,34 +6660,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -6800,7 +6754,7 @@ - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -6823,53 +6777,59 @@ The specified in the constructor. + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. + A [] or null if the next JSON token is null. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6896,7 +6856,7 @@ All public and private fields are serialized. Members can be excluded using or . This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. + and setting IgnoreSerializableAttribute on to false. @@ -6926,9 +6886,9 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -6937,7 +6897,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6945,49 +6905,50 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -6995,7 +6956,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -7003,7 +6964,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -7011,7 +6972,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -7027,13 +6988,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -7044,13 +7007,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -7111,13 +7076,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -7155,7 +7120,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -7165,7 +7130,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -7175,18 +7140,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -7300,9 +7267,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -7312,9 +7279,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -7390,19 +7357,19 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -7429,7 +7396,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7437,8 +7404,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -7481,7 +7448,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7489,8 +7456,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -7527,13 +7494,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -7564,7 +7531,7 @@ - The Read method has not been called. + A read method has not been called. @@ -7599,7 +7566,7 @@ - The Close method has been called. + The method has been called. @@ -7614,7 +7581,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -7635,12 +7602,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -7649,7 +7614,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -7659,22 +7625,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -7694,7 +7660,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -7715,56 +7681,56 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -7789,25 +7755,21 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -7824,22 +7786,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -7854,7 +7816,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -8035,7 +7997,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -8045,7 +8007,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -8053,8 +8015,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -8063,7 +8025,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -8074,11 +8036,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -8089,9 +8051,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -8101,13 +8063,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -8127,7 +8089,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -8153,7 +8115,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -8166,14 +8128,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -8194,7 +8156,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -8215,7 +8177,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -8234,52 +8196,52 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - Serializes the XML node to a JSON string. + Serializes the to a JSON string. The node to serialize. - A JSON string of the XmlNode. + A JSON string of the . - Serializes the XML node to a JSON string using formatting. + Serializes the to a JSON string using formatting. The node to serialize. - Indicates how the output is formatted. - A JSON string of the XmlNode. + Indicates how the output should be formatted. + A JSON string of the . - Serializes the XML node to a JSON string using formatting and omits the root object if is true. + Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XmlNode. + A JSON string of the . - Deserializes the XmlNode from a JSON string. + Deserializes the from a JSON string. The JSON string. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -8287,7 +8249,7 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XmlNode + The deserialized . @@ -8312,7 +8274,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -8320,8 +8282,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -8367,8 +8329,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -8390,22 +8352,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -8451,39 +8413,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -8610,7 +8573,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -8618,33 +8581,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -8761,7 +8724,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -8769,8 +8732,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -8890,7 +8853,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -8934,9 +8897,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -8952,15 +8915,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -9049,7 +9012,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -9091,18 +9054,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -9292,9 +9255,9 @@ Specifies type name handling options for the . - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -9322,7 +9285,7 @@ Include the .NET type name when the type of the object being serialized is not the same as its declared type. Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON you must specify a root type object with - or . + or . @@ -9332,7 +9295,7 @@ - This is returned by the if a method has not been called. + This is returned by the if a read method has not been called. @@ -9427,12 +9390,18 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -9453,34 +9422,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -9490,17 +9459,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -9536,13 +9507,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -9573,7 +9544,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -9728,99 +9700,99 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -9843,27 +9815,27 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. @@ -9875,12 +9847,12 @@ An exception has been thrown, which has left the in an invalid state. You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. + Any other method calls result in an being thrown. - The method has been called. + The method has been called. @@ -9890,7 +9862,7 @@ - A array is being written. + An array is being written. @@ -9905,7 +9877,7 @@ - A write method has not been called. + A write method has not been called. diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/net35/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net35/Newtonsoft.Json.dll new file mode 100644 index 000000000..e5f07f120 Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net35/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net35/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net35/Newtonsoft.Json.xml similarity index 89% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/net35/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/net35/Newtonsoft.Json.xml index 9df8fe0f5..5343fd4b1 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net35/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net35/Newtonsoft.Json.xml @@ -6,12 +6,12 @@ - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. @@ -35,19 +35,19 @@ Initializes a new instance of the class. - The stream. + The containing the BSON data to read. Initializes a new instance of the class. - The reader. + The containing the BSON data to read. Initializes a new instance of the class. - The stream. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. @@ -55,13 +55,13 @@ Initializes a new instance of the class. - The reader. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -69,12 +69,13 @@ - Changes the to Closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. @@ -88,17 +89,17 @@ Initializes a new instance of the class. - The stream. + The to write to. Initializes a new instance of the class. - The writer. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. @@ -109,7 +110,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -149,7 +150,9 @@ - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -417,7 +420,7 @@ - Create a custom object + Creates a custom object. The object type to convert. @@ -479,7 +482,7 @@ - Converts an Entity Framework EntityKey to and from JSON. + Converts an Entity Framework to and from JSON. @@ -662,7 +665,7 @@ - Converts a to and from a string (e.g. "1.2.3.4"). + Converts a to and from a string (e.g. "1.2.3.4"). @@ -694,7 +697,7 @@ - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). @@ -735,7 +738,7 @@ - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). @@ -763,16 +766,16 @@ - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. - The name of the deserialize root element. + The name of the deserialized root element. Gets or sets a flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - true if the array attibute is written to the XML; otherwise, false. + true if the array attribute is written to the XML; otherwise, false. @@ -800,7 +803,7 @@ - Checks if the attributeName is a namespace attribute. + Checks if the is a namespace attribute. Attribute name to test. The attribute name prefix if it has one, otherwise an empty string. @@ -822,7 +825,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -837,17 +840,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -857,12 +860,12 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -899,18 +902,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -951,7 +954,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -1006,7 +1009,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1014,8 +1017,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -1046,7 +1049,7 @@ - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -1106,23 +1109,20 @@ The value of a property for a given component. - The component with the property for which to retrieve the value. - + The component with the property for which to retrieve the value. When overridden in a derived class, resets the value for this property of the component to the default value. - The component with the property value that is to be reset to the default value. - + The component with the property value that is to be reset to the default value. When overridden in a derived class, sets the value of the component to a different value. - The component with the property value that is to be set. - The new value. - + The component with the property value that is to be set. + The new value. @@ -1138,7 +1138,10 @@ When overridden in a derived class, gets the type of the component this property is bound to. - A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. + A that represents the type of component this property is bound to. + When the or + + methods are invoked, the object specified might be an instance of this type. @@ -1196,7 +1199,7 @@ - Gets or sets how how null value properties are merged. + Gets or sets how null value properties are merged. How null value properties are merged. @@ -1260,11 +1263,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -1289,7 +1292,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -1485,18 +1488,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -1577,13 +1580,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -1599,13 +1602,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -1631,13 +1634,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -1652,23 +1655,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -1753,22 +1748,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -1784,7 +1779,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -1794,11 +1789,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -1823,7 +1818,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -1837,7 +1832,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -1845,7 +1840,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -1898,7 +1893,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -1906,7 +1901,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -1924,106 +1919,6 @@ Name of the property. - - - Returns the properties for this instance of a component. - - - A that represents the properties for this component instance. - - - - - Returns the properties for this instance of a component using the attribute array as a filter. - - An array of type that is used as a filter. - - A that represents the filtered properties for this component instance. - - - - - Returns a collection of custom attributes for this instance of a component. - - - An containing the attributes for this object. - - - - - Returns the class name of this instance of a component. - - - The class name of the object, or null if the class does not have a name. - - - - - Returns the name of this instance of a component. - - - The name of the object, or null if the object does not have a name. - - - - - Returns a type converter for this instance of a component. - - - A that is the converter for this object, or null if there is no for this object. - - - - - Returns the default event for this instance of a component. - - - An that represents the default event for this object, or null if this object does not have events. - - - - - Returns the default property for this instance of a component. - - - A that represents the default property for this object, or null if this object does not have properties. - - - - - Returns an editor of the specified type for this instance of a component. - - A that represents the editor for this object. - - An of the specified type that is the editor for this object, or null if the editor cannot be found. - - - - - Returns the events for this instance of a component using the specified attribute array as a filter. - - An array of type that is used as a filter. - - An that represents the filtered events for this component instance. - - - - - Returns the events for this instance of a component. - - - An that represents the events for this component instance. - - - - - Returns an object that contains the property described by the specified property descriptor. - - A that represents the property whose owner is to be found. - - An that represents the owner of the specified property. - - Represents a JSON array. @@ -2080,7 +1975,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -2099,7 +1994,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -2110,7 +2005,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -2118,7 +2013,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -2141,84 +2036,81 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. @@ -2238,7 +2130,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2261,9 +2153,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -2278,13 +2170,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -2317,7 +2213,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -2339,7 +2235,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -2637,8 +2533,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -2657,49 +2553,49 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2748,56 +2644,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2811,14 +2707,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2874,7 +2770,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2888,7 +2784,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2923,7 +2819,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -2937,49 +2833,49 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3007,7 +2903,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3021,14 +2917,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3042,28 +2938,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3126,7 +3022,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3140,23 +3036,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -3164,25 +3060,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -3190,7 +3086,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -3200,9 +3096,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3213,9 +3109,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3233,18 +3129,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3253,9 +3149,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3267,7 +3163,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -3286,7 +3182,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -3296,7 +3192,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -3329,7 +3225,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -3408,18 +3304,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -3663,7 +3559,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -3682,9 +3578,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -3747,7 +3640,7 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. @@ -3787,6 +3680,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -3819,8 +3727,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -3843,7 +3751,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -3851,7 +3759,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -3883,8 +3791,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -3940,8 +3848,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -3985,6 +3893,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -3997,9 +3911,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -4029,7 +3950,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -4037,7 +3958,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -4057,6 +3978,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -4076,9 +4012,9 @@ - Gets or sets the ISerializable object constructor. + Gets or sets the object constructor. - The ISerializable object constructor. + The object constructor. @@ -4169,7 +4105,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -4230,7 +4166,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -4356,6 +4292,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -4395,8 +4338,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -4435,7 +4378,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -4629,7 +4572,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -4730,7 +4673,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -4816,9 +4759,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -4860,13 +4803,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -4897,7 +4840,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -4922,11 +4865,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -4977,7 +4920,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -4988,8 +4931,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -5021,6 +4964,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -5040,11 +4989,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -5109,12 +5058,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. @@ -5168,13 +5117,13 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -5187,21 +5136,21 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -5277,7 +5226,7 @@ - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. @@ -5312,7 +5261,7 @@ Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . @@ -5348,20 +5297,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -5381,7 +5330,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -5422,13 +5371,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -5439,13 +5390,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -5505,7 +5458,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -5519,7 +5472,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -5535,8 +5488,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -5550,7 +5503,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -5595,7 +5548,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -5619,7 +5572,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -5641,8 +5594,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -5727,7 +5680,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -5742,34 +5696,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -5836,7 +5790,7 @@ - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -5859,59 +5813,65 @@ The specified in the constructor. + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. + A [] or null if the next JSON token is null. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -5938,7 +5898,7 @@ All public and private fields are serialized. Members can be excluded using or . This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. + and setting IgnoreSerializableAttribute on to false. @@ -5968,9 +5928,9 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -5979,7 +5939,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -5987,55 +5947,56 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -6043,7 +6004,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -6051,7 +6012,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -6059,7 +6020,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -6075,13 +6036,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -6092,13 +6055,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -6159,13 +6124,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -6203,7 +6168,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -6213,7 +6178,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -6223,18 +6188,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -6348,9 +6315,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -6360,9 +6327,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -6444,19 +6411,19 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -6483,7 +6450,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -6491,8 +6458,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -6535,7 +6502,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -6543,8 +6510,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -6581,13 +6548,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -6618,7 +6585,7 @@ - The Read method has not been called. + A read method has not been called. @@ -6653,7 +6620,7 @@ - The Close method has been called. + The method has been called. @@ -6668,7 +6635,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -6689,12 +6656,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -6703,7 +6668,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -6713,22 +6679,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -6748,7 +6714,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -6769,62 +6735,62 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -6849,25 +6815,21 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -6884,22 +6846,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -6914,7 +6876,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -7110,7 +7072,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -7120,7 +7082,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -7128,8 +7090,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -7138,7 +7100,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -7149,11 +7111,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -7164,9 +7126,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -7176,13 +7138,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -7202,7 +7164,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -7228,7 +7190,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -7241,14 +7203,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -7269,7 +7231,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -7290,7 +7252,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -7309,52 +7271,52 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - Serializes the XML node to a JSON string. + Serializes the to a JSON string. The node to serialize. - A JSON string of the XmlNode. + A JSON string of the . - Serializes the XML node to a JSON string using formatting. + Serializes the to a JSON string using formatting. The node to serialize. - Indicates how the output is formatted. - A JSON string of the XmlNode. + Indicates how the output should be formatted. + A JSON string of the . - Serializes the XML node to a JSON string using formatting and omits the root object if is true. + Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XmlNode. + A JSON string of the . - Deserializes the XmlNode from a JSON string. + Deserializes the from a JSON string. The JSON string. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -7362,51 +7324,51 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XmlNode + The deserialized . Serializes the to a JSON string. The node to convert to JSON. - A JSON string of the XNode. + A JSON string of the . Serializes the to a JSON string using formatting. The node to convert to JSON. - Indicates how the output is formatted. - A JSON string of the XNode. + Indicates how the output should be formatted. + A JSON string of the . Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XNode. + A JSON string of the . Deserializes the from a JSON string. The JSON string. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -7414,7 +7376,7 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XNode + The deserialized . @@ -7439,7 +7401,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7447,8 +7409,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -7494,8 +7456,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -7517,22 +7479,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -7578,39 +7540,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -7737,7 +7700,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -7745,33 +7708,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -7888,7 +7851,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7896,8 +7859,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -8017,7 +7980,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -8061,9 +8024,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -8079,15 +8042,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -8176,7 +8139,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -8218,18 +8181,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -8419,9 +8382,9 @@ Specifies type name handling options for the . - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -8449,7 +8412,7 @@ Include the .NET type name when the type of the object being serialized is not the same as its declared type. Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON you must specify a root type object with - or . + or . @@ -8459,7 +8422,7 @@ - This is returned by the if a method has not been called. + This is returned by the if a read method has not been called. @@ -8554,12 +8517,18 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -8580,34 +8549,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -8617,17 +8586,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -8663,13 +8634,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -8700,7 +8671,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -8861,105 +8833,105 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -8982,27 +8954,27 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. @@ -9014,12 +8986,12 @@ An exception has been thrown, which has left the in an invalid state. You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. + Any other method calls result in an being thrown. - The method has been called. + The method has been called. @@ -9029,7 +9001,7 @@ - A array is being written. + An array is being written. @@ -9044,7 +9016,7 @@ - A write method has not been called. + A write method has not been called. diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/net40/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net40/Newtonsoft.Json.dll new file mode 100644 index 000000000..9e614751f Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net40/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net40/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net40/Newtonsoft.Json.xml similarity index 89% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/net40/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/net40/Newtonsoft.Json.xml index 8fa593057..06696cef7 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net40/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net40/Newtonsoft.Json.xml @@ -6,12 +6,12 @@ - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. @@ -35,19 +35,19 @@ Initializes a new instance of the class. - The stream. + The containing the BSON data to read. Initializes a new instance of the class. - The reader. + The containing the BSON data to read. Initializes a new instance of the class. - The stream. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. @@ -55,13 +55,13 @@ Initializes a new instance of the class. - The reader. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -69,12 +69,13 @@ - Changes the to Closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. @@ -88,17 +89,17 @@ Initializes a new instance of the class. - The stream. + The to write to. Initializes a new instance of the class. - The writer. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. @@ -109,7 +110,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -149,7 +150,9 @@ - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -417,7 +420,7 @@ - Create a custom object + Creates a custom object. The object type to convert. @@ -511,7 +514,7 @@ - Converts an Entity Framework EntityKey to and from JSON. + Converts an Entity Framework to and from JSON. @@ -543,7 +546,7 @@ - Converts an ExpandoObject to and from JSON. + Converts an to and from JSON. @@ -734,7 +737,7 @@ - Converts a to and from a string (e.g. "1.2.3.4"). + Converts a to and from a string (e.g. "1.2.3.4"). @@ -766,7 +769,7 @@ - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). @@ -807,7 +810,7 @@ - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). @@ -835,16 +838,16 @@ - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. - The name of the deserialize root element. + The name of the deserialized root element. Gets or sets a flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - true if the array attibute is written to the XML; otherwise, false. + true if the array attribute is written to the XML; otherwise, false. @@ -872,7 +875,7 @@ - Checks if the attributeName is a namespace attribute. + Checks if the is a namespace attribute. Attribute name to test. The attribute name prefix if it has one, otherwise an empty string. @@ -894,7 +897,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -910,18 +913,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -947,7 +950,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -997,7 +1000,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1005,8 +1008,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -1015,17 +1018,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -1035,12 +1038,12 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -1118,7 +1121,7 @@ - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -1181,7 +1184,7 @@ - Gets or sets how how null value properties are merged. + Gets or sets how null value properties are merged. How null value properties are merged. @@ -1268,23 +1271,20 @@ The value of a property for a given component. - The component with the property for which to retrieve the value. - + The component with the property for which to retrieve the value. When overridden in a derived class, resets the value for this property of the component to the default value. - The component with the property value that is to be reset to the default value. - + The component with the property value that is to be reset to the default value. When overridden in a derived class, sets the value of the component to a different value. - The component with the property value that is to be set. - The new value. - + The component with the property value that is to be set. + The new value. @@ -1300,7 +1300,10 @@ When overridden in a derived class, gets the type of the component this property is bound to. - A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. + A that represents the type of component this property is bound to. + When the or + + methods are invoked, the object specified might be an instance of this type. @@ -1332,11 +1335,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -1361,7 +1364,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -1557,18 +1560,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -1660,13 +1663,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -1682,13 +1685,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -1714,13 +1717,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -1735,23 +1738,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -1836,22 +1831,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -1867,7 +1862,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -1877,11 +1872,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -1906,7 +1901,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -1920,7 +1915,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -1928,7 +1923,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -1981,7 +1976,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -1989,7 +1984,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -2007,106 +2002,6 @@ Name of the property. - - - Returns the properties for this instance of a component. - - - A that represents the properties for this component instance. - - - - - Returns the properties for this instance of a component using the attribute array as a filter. - - An array of type that is used as a filter. - - A that represents the filtered properties for this component instance. - - - - - Returns a collection of custom attributes for this instance of a component. - - - An containing the attributes for this object. - - - - - Returns the class name of this instance of a component. - - - The class name of the object, or null if the class does not have a name. - - - - - Returns the name of this instance of a component. - - - The name of the object, or null if the object does not have a name. - - - - - Returns a type converter for this instance of a component. - - - A that is the converter for this object, or null if there is no for this object. - - - - - Returns the default event for this instance of a component. - - - An that represents the default event for this object, or null if this object does not have events. - - - - - Returns the default property for this instance of a component. - - - A that represents the default property for this object, or null if this object does not have properties. - - - - - Returns an editor of the specified type for this instance of a component. - - A that represents the editor for this object. - - An of the specified type that is the editor for this object, or null if the editor cannot be found. - - - - - Returns the events for this instance of a component using the specified attribute array as a filter. - - An array of type that is used as a filter. - - An that represents the filtered events for this component instance. - - - - - Returns the events for this instance of a component. - - - An that represents the events for this component instance. - - - - - Returns an object that contains the property described by the specified property descriptor. - - A that represents the property whose owner is to be found. - - An that represents the owner of the specified property. - - Returns the responsible for binding operations performed on this object. @@ -2172,7 +2067,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -2191,7 +2086,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -2202,7 +2097,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -2210,7 +2105,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -2233,84 +2128,81 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. @@ -2330,7 +2222,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2353,9 +2245,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -2370,13 +2262,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -2409,7 +2305,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -2431,7 +2327,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -2729,8 +2625,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -2749,49 +2645,49 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2840,56 +2736,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2903,14 +2799,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2966,7 +2862,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -2980,7 +2876,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -3015,7 +2911,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3029,49 +2925,49 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3099,7 +2995,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3113,14 +3009,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3134,28 +3030,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3218,7 +3114,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -3232,23 +3128,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -3256,25 +3152,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -3282,7 +3178,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -3292,9 +3188,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3305,9 +3201,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3325,18 +3221,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3345,9 +3241,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -3359,7 +3255,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -3378,7 +3274,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -3388,7 +3284,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -3439,7 +3335,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -3518,18 +3414,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -3773,7 +3669,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -3792,9 +3688,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -3866,7 +3759,7 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. @@ -3906,6 +3799,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -3938,8 +3846,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -3987,7 +3895,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -3995,7 +3903,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -4027,8 +3935,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -4084,8 +3992,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -4129,6 +4037,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -4141,9 +4055,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -4173,7 +4094,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -4181,7 +4102,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -4201,6 +4122,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -4243,9 +4179,9 @@ - Gets or sets the ISerializable object constructor. + Gets or sets the object constructor. - The ISerializable object constructor. + The object constructor. @@ -4336,7 +4272,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -4397,7 +4333,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -4530,6 +4466,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -4569,8 +4512,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -4609,7 +4552,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -4803,7 +4746,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -4904,7 +4847,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -4990,9 +4933,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -5034,13 +4977,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -5071,7 +5014,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -5096,11 +5039,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -5151,7 +5094,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -5162,8 +5105,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -5195,6 +5138,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -5214,11 +5163,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -5283,21 +5232,21 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. - + Helper method for generating a MetaObject which calls a specific method on Dynamic that returns a result - + Helper method for generating a MetaObject which calls a specific method on Dynamic, but uses one of the arguments for @@ -5368,13 +5317,13 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -5387,21 +5336,21 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -5477,7 +5426,7 @@ - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. @@ -5512,7 +5461,7 @@ Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . @@ -5548,20 +5497,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -5581,7 +5530,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -5622,13 +5571,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -5639,13 +5590,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -5705,7 +5658,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -5719,7 +5672,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -5735,8 +5688,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -5750,7 +5703,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -5795,7 +5748,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -5819,7 +5772,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -5841,8 +5794,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -5927,7 +5880,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -5942,34 +5896,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -6036,7 +5990,7 @@ - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -6059,59 +6013,65 @@ The specified in the constructor. + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. + A [] or null if the next JSON token is null. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6138,7 +6098,7 @@ All public and private fields are serialized. Members can be excluded using or . This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. + and setting IgnoreSerializableAttribute on to false. @@ -6168,9 +6128,9 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -6179,7 +6139,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6187,55 +6147,56 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -6243,7 +6204,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -6251,7 +6212,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -6259,7 +6220,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -6275,13 +6236,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -6292,13 +6255,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -6359,13 +6324,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -6403,7 +6368,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -6413,7 +6378,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -6423,18 +6388,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -6548,9 +6515,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -6560,9 +6527,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -6644,19 +6611,19 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -6683,7 +6650,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -6691,8 +6658,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -6735,7 +6702,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -6743,8 +6710,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -6781,13 +6748,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -6818,7 +6785,7 @@ - The Read method has not been called. + A read method has not been called. @@ -6853,7 +6820,7 @@ - The Close method has been called. + The method has been called. @@ -6868,7 +6835,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -6889,12 +6856,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -6903,7 +6868,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -6913,22 +6879,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -6948,7 +6914,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -6969,62 +6935,62 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -7049,25 +7015,21 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -7084,22 +7046,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -7114,7 +7076,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -7310,7 +7272,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -7320,7 +7282,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -7328,8 +7290,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -7338,7 +7300,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -7349,11 +7311,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -7364,9 +7326,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -7376,13 +7338,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -7395,7 +7357,7 @@ The object to serialize. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -7404,9 +7366,9 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -7415,11 +7377,11 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -7436,7 +7398,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -7462,7 +7424,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -7475,14 +7437,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -7503,7 +7465,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -7524,7 +7486,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -7536,7 +7498,7 @@ The type of the object to deserialize to. The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -7548,10 +7510,10 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -7561,7 +7523,7 @@ The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -7573,10 +7535,10 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -7594,7 +7556,7 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. @@ -7605,55 +7567,55 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous populate operation. + A task that represents the asynchronous population operation. - Serializes the XML node to a JSON string. + Serializes the to a JSON string. The node to serialize. - A JSON string of the XmlNode. + A JSON string of the . - Serializes the XML node to a JSON string using formatting. + Serializes the to a JSON string using formatting. The node to serialize. - Indicates how the output is formatted. - A JSON string of the XmlNode. + Indicates how the output should be formatted. + A JSON string of the . - Serializes the XML node to a JSON string using formatting and omits the root object if is true. + Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XmlNode. + A JSON string of the . - Deserializes the XmlNode from a JSON string. + Deserializes the from a JSON string. The JSON string. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -7661,51 +7623,51 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XmlNode + The deserialized . Serializes the to a JSON string. The node to convert to JSON. - A JSON string of the XNode. + A JSON string of the . Serializes the to a JSON string using formatting. The node to convert to JSON. - Indicates how the output is formatted. - A JSON string of the XNode. + Indicates how the output should be formatted. + A JSON string of the . Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XNode. + A JSON string of the . Deserializes the from a JSON string. The JSON string. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -7713,7 +7675,7 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XNode + The deserialized . @@ -7738,7 +7700,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7746,8 +7708,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -7793,8 +7755,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -7816,22 +7778,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -7877,39 +7839,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -8036,7 +7999,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -8044,33 +8007,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -8187,7 +8150,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -8195,8 +8158,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -8316,7 +8279,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -8360,9 +8323,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -8378,15 +8341,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -8475,7 +8438,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -8517,18 +8480,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -8718,9 +8681,9 @@ Specifies type name handling options for the . - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -8748,7 +8711,7 @@ Include the .NET type name when the type of the object being serialized is not the same as its declared type. Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON you must specify a root type object with - or . + or . @@ -8758,7 +8721,7 @@ - This is returned by the if a method has not been called. + This is returned by the if a read method has not been called. @@ -8853,12 +8816,18 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -8879,34 +8848,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -8916,17 +8885,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -8962,13 +8933,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -8999,7 +8970,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -9160,105 +9132,105 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -9281,27 +9253,27 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. @@ -9313,12 +9285,12 @@ An exception has been thrown, which has left the in an invalid state. You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. + Any other method calls result in an being thrown. - The method has been called. + The method has been called. @@ -9328,7 +9300,7 @@ - A array is being written. + An array is being written. @@ -9343,7 +9315,7 @@ - A write method has not been called. + A write method has not been called. diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/net45/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net45/Newtonsoft.Json.dll new file mode 100644 index 000000000..7379a6b7b Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net45/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net45/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net45/Newtonsoft.Json.xml similarity index 70% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/net45/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/net45/Newtonsoft.Json.xml index 41c27d855..87b27f390 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/net45/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/net45/Newtonsoft.Json.xml @@ -23,12 +23,12 @@ - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. @@ -52,19 +52,19 @@ Initializes a new instance of the class. - The stream. + The containing the BSON data to read. Initializes a new instance of the class. - The reader. + The containing the BSON data to read. Initializes a new instance of the class. - The stream. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. @@ -72,13 +72,13 @@ Initializes a new instance of the class. - The reader. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -86,12 +86,13 @@ - Changes the to Closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. @@ -105,17 +106,17 @@ Initializes a new instance of the class. - The stream. + The to write to. Initializes a new instance of the class. - The writer. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. @@ -126,7 +127,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -166,7 +167,9 @@ - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -326,7 +329,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -400,7 +403,7 @@ - Create a custom object + Creates a custom object. The object type to convert. @@ -558,7 +561,7 @@ - Converts an Entity Framework EntityKey to and from JSON. + Converts an Entity Framework to and from JSON. @@ -590,7 +593,7 @@ - Converts an ExpandoObject to and from JSON. + Converts an to and from JSON. @@ -630,7 +633,7 @@ - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). @@ -671,7 +674,7 @@ - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). @@ -813,7 +816,7 @@ - Converts a to and from a string (e.g. "1.2.3.4"). + Converts a to and from a string (e.g. "1.2.3.4"). @@ -850,16 +853,16 @@ - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. - The name of the deserialize root element. + The name of the deserialized root element. Gets or sets a flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - true if the array attibute is written to the XML; otherwise, false. + true if the array attribute is written to the XML; otherwise, false. @@ -887,7 +890,7 @@ - Checks if the attributeName is a namespace attribute. + Checks if the is a namespace attribute. Attribute name to test. The attribute name prefix if it has one, otherwise an empty string. @@ -924,17 +927,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -944,12 +947,12 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -996,7 +999,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -1010,7 +1013,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -1021,18 +1024,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -1058,7 +1061,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -1079,20 +1082,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -1112,7 +1115,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -1158,13 +1161,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -1175,13 +1180,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -1225,7 +1232,7 @@ - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -1242,22 +1249,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -1272,7 +1279,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -1468,7 +1475,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -1478,7 +1485,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -1486,8 +1493,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -1496,7 +1503,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -1507,11 +1514,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -1522,9 +1529,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -1534,13 +1541,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -1553,7 +1560,7 @@ The object to serialize. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -1562,9 +1569,9 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -1573,11 +1580,11 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -1594,7 +1601,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1620,7 +1627,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -1633,14 +1640,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -1661,7 +1668,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1682,7 +1689,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1694,7 +1701,7 @@ The type of the object to deserialize to. The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1706,10 +1713,10 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1719,7 +1726,7 @@ The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1731,10 +1738,10 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1752,7 +1759,7 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. @@ -1763,55 +1770,55 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous populate operation. + A task that represents the asynchronous population operation. - Serializes the XML node to a JSON string. + Serializes the to a JSON string. The node to serialize. - A JSON string of the XmlNode. + A JSON string of the . - Serializes the XML node to a JSON string using formatting. + Serializes the to a JSON string using formatting. The node to serialize. - Indicates how the output is formatted. - A JSON string of the XmlNode. + Indicates how the output should be formatted. + A JSON string of the . - Serializes the XML node to a JSON string using formatting and omits the root object if is true. + Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XmlNode. + A JSON string of the . - Deserializes the XmlNode from a JSON string. + Deserializes the from a JSON string. The JSON string. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XmlNode + The deserialized . - Deserializes the XmlNode from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -1819,51 +1826,51 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XmlNode + The deserialized . Serializes the to a JSON string. The node to convert to JSON. - A JSON string of the XNode. + A JSON string of the . Serializes the to a JSON string using formatting. The node to convert to JSON. - Indicates how the output is formatted. - A JSON string of the XNode. + Indicates how the output should be formatted. + A JSON string of the . Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XNode. + A JSON string of the . Deserializes the from a JSON string. The JSON string. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -1871,7 +1878,7 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XNode + The deserialized . @@ -1908,13 +1915,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -1941,8 +1948,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -1956,7 +1963,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -2002,7 +2009,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -2010,8 +2017,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -2094,13 +2101,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -2111,13 +2120,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -2178,13 +2189,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -2210,6 +2221,105 @@ Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously skips the children of the current token. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + Specifies the state of the reader. @@ -2217,7 +2327,7 @@ - The Read method has not been called. + A read method has not been called. @@ -2252,7 +2362,7 @@ - The Close method has been called. + The method has been called. @@ -2267,7 +2377,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -2288,12 +2398,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -2302,7 +2410,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -2312,22 +2421,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -2347,7 +2456,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -2368,62 +2477,62 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -2448,20 +2557,16 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. @@ -2505,7 +2610,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -2513,12 +2618,12 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -2544,7 +2649,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -2552,8 +2657,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -2599,8 +2704,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -2622,22 +2727,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -2683,39 +2788,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -2842,7 +2948,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -2850,33 +2956,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -2888,7 +2994,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -2912,7 +3018,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -2934,8 +3040,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -3020,7 +3126,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -3035,34 +3142,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -3088,11 +3195,101 @@ Represents a reader that provides fast, non-cached, forward-only access to JSON text data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -3101,7 +3298,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -3109,55 +3306,56 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -3165,7 +3363,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -3173,7 +3371,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -3181,7 +3379,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -3189,6 +3387,585 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + Gets or sets the writer's character array pool. @@ -3196,7 +3973,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -3206,7 +3983,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -3216,18 +3993,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -3341,9 +4120,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3353,9 +4132,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3437,13 +4216,13 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. @@ -3454,7 +4233,7 @@ - This is returned by the if a method has not been called. + This is returned by the if a read method has not been called. @@ -3588,7 +4367,7 @@ - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -3611,59 +4390,65 @@ The specified in the constructor. + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. + A [] or null if the next JSON token is null. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -3674,14 +4459,656 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + null can be passed to the method for tokens that don't have a value, e.g. . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously ets the state of the . + + The being written. + The value being written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -3702,34 +5129,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -3739,17 +5166,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -3785,13 +5214,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -3822,7 +5251,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -3983,105 +5413,105 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -4104,32 +5534,32 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -4156,7 +5586,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -4164,8 +5594,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -4326,11 +5756,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -4342,6 +5772,34 @@ + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4390,7 +5848,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4409,7 +5867,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -4420,7 +5878,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -4428,7 +5886,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -4451,90 +5909,118 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. Represents a JSON constructor. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4599,18 +6085,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4702,13 +6188,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -4724,13 +6210,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -4756,13 +6242,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -4777,23 +6263,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -4831,6 +6309,37 @@ + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4878,22 +6387,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -4909,7 +6418,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -4919,11 +6428,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -4948,7 +6457,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -4962,7 +6471,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -4970,7 +6479,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -5023,7 +6532,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -5031,7 +6540,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -5049,106 +6558,6 @@ Name of the property. - - - Returns the properties for this instance of a component. - - - A that represents the properties for this component instance. - - - - - Returns the properties for this instance of a component using the attribute array as a filter. - - An array of type that is used as a filter. - - A that represents the filtered properties for this component instance. - - - - - Returns a collection of custom attributes for this instance of a component. - - - An containing the attributes for this object. - - - - - Returns the class name of this instance of a component. - - - The class name of the object, or null if the class does not have a name. - - - - - Returns the name of this instance of a component. - - - The name of the object, or null if the object does not have a name. - - - - - Returns a type converter for this instance of a component. - - - A that is the converter for this object, or null if there is no for this object. - - - - - Returns the default event for this instance of a component. - - - An that represents the default event for this object, or null if this object does not have events. - - - - - Returns the default property for this instance of a component. - - - A that represents the default property for this object, or null if this object does not have properties. - - - - - Returns an editor of the specified type for this instance of a component. - - A that represents the editor for this object. - - An of the specified type that is the editor for this object, or null if the editor cannot be found. - - - - - Returns the events for this instance of a component using the specified attribute array as a filter. - - An array of type that is used as a filter. - - An that represents the filtered events for this component instance. - - - - - Returns the events for this instance of a component. - - - An that represents the events for this component instance. - - - - - Returns an object that contains the property described by the specified property descriptor. - - A that represents the property whose owner is to be found. - - An that represents the owner of the specified property. - - Returns the responsible for binding operations performed on this object. @@ -5158,28 +6567,40 @@ The to bind this object. - - - Specifies the settings used when merging JSON. - - - - - Gets or sets the method used when merging JSON arrays. - - The method used when merging JSON arrays. - - - - Gets or sets how how null value properties are merged. - - How null value properties are merged. - Represents a JSON property. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -5233,20 +6654,70 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . + + + Represents a raw JSON string. + + + + + Asynchronously creates an instance of with the content of the reader's current token. + + The reader. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns an instance of with the content of the reader's current token. + + + + Initializes a new instance of the class from another object. + + A object to copy from. + + + + Initializes a new instance of the class. + + The raw json. + + + + Creates an instance of with the content of the reader's current token. + + The reader. + An instance of with the content of the reader's current token. + + + + Specifies the settings used when merging JSON. + + + + + Gets or sets the method used when merging JSON arrays. + + The method used when merging JSON arrays. + + + + Gets or sets how null value properties are merged. + + How null value properties are merged. + Represents a view of a . @@ -5274,23 +6745,20 @@ The value of a property for a given component. - The component with the property for which to retrieve the value. - + The component with the property for which to retrieve the value. When overridden in a derived class, resets the value for this property of the component to the default value. - The component with the property value that is to be reset to the default value. - + The component with the property value that is to be reset to the default value. When overridden in a derived class, sets the value of the component to a different value. - The component with the property value that is to be set. - The new value. - + The component with the property value that is to be set. + The new value. @@ -5306,7 +6774,10 @@ When overridden in a derived class, gets the type of the component this property is bound to. - A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. + A that represents the type of component this property is bound to. + When the or + + methods are invoked, the object specified might be an instance of this type. @@ -5334,35 +6805,86 @@ The hash code for the name of the member. - - - Represents a raw JSON string. - - - - - Initializes a new instance of the class from another object. - - A object to copy from. - - - - Initializes a new instance of the class. - - The raw json. - - - - Creates an instance of with the content of the reader's current token. - - The reader. - An instance of with the content of the reader's current token. - Represents an abstract JSON token. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Writes this token to a asynchronously. + + A into which this method will write. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + Gets a comparer that can compare two tokens for value equality. @@ -5532,8 +7054,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -5552,49 +7074,49 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5643,56 +7165,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5706,14 +7228,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5769,7 +7291,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5783,7 +7305,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5818,7 +7340,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5832,49 +7354,49 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5902,7 +7424,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5916,14 +7438,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5937,28 +7459,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -6021,7 +7543,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -6035,23 +7557,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -6059,25 +7581,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -6085,7 +7607,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -6095,9 +7617,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6108,9 +7630,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6128,18 +7650,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6148,9 +7670,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6162,7 +7684,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -6181,7 +7703,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -6191,7 +7713,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -6242,7 +7764,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -6284,7 +7806,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -6304,7 +7826,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6422,9 +7944,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -6439,13 +7961,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -6478,7 +8004,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -6500,7 +8026,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -6629,6 +8155,15 @@ Represents a value in JSON (string, integer, date, etc). + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + Initializes a new instance of the class from another object. @@ -6770,7 +8305,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -6789,9 +8324,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -6863,7 +8395,7 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. @@ -6936,7 +8468,7 @@ All public and private fields are serialized. Members can be excluded using or . This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. + and setting IgnoreSerializableAttribute on to false. @@ -7016,7 +8548,7 @@ Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . @@ -7180,7 +8712,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -7224,9 +8756,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -7242,15 +8774,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -7339,7 +8871,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -7381,18 +8913,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -7461,7 +8993,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7469,8 +9001,8 @@ The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. - The parameter is null. - The class name is null or is zero (0). + The parameter is null. + The class name is null or is zero (0). @@ -7709,6 +9241,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -7738,6 +9285,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -7762,7 +9324,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7823,7 +9385,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -7956,6 +9518,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -8007,8 +9576,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -8018,8 +9587,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8151,7 +9720,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8159,12 +9728,12 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -8189,6 +9758,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -8201,9 +9776,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -8229,11 +9811,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -8265,8 +9847,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8493,7 +10075,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -8574,9 +10156,9 @@ - Gets or sets the ISerializable object constructor. + Gets or sets the object constructor. - The ISerializable object constructor. + The object constructor. @@ -8622,7 +10204,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -8633,8 +10215,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -8666,6 +10248,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -8733,7 +10321,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -8819,9 +10407,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -8863,13 +10451,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -8900,7 +10488,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -8927,11 +10515,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -8942,8 +10530,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -9002,7 +10590,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -9010,7 +10598,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -9045,12 +10633,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. @@ -9078,9 +10666,9 @@ Specifies type name handling options for the . - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -9108,21 +10696,21 @@ Include the .NET type name when the type of the object being serialized is not the same as its declared type. Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON you must specify a root type object with - or . + or . - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -9178,17 +10766,17 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - + Helper method for generating a MetaObject which calls a specific method on Dynamic that returns a result - + Helper method for generating a MetaObject which calls a specific method on Dynamic, but uses one of the arguments for @@ -9210,7 +10798,7 @@ - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -9292,12 +10880,12 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. @@ -9313,12 +10901,12 @@ An exception has been thrown, which has left the in an invalid state. You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. + Any other method calls result in an being thrown. - The method has been called. + The method has been called. @@ -9328,7 +10916,7 @@ - A array is being written. + An array is being written. @@ -9343,7 +10931,7 @@ - A write method has not been called. + A write method has not been called. diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.0/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.0/Newtonsoft.Json.dll new file mode 100644 index 000000000..7c815a79a Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.0/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.0/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.0/Newtonsoft.Json.xml similarity index 69% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.0/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.0/Newtonsoft.Json.xml index 74c186c97..dcf508f03 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.0/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.0/Newtonsoft.Json.xml @@ -11,7 +11,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -26,17 +26,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -46,12 +46,12 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -98,7 +98,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -112,7 +112,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -123,18 +123,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -175,7 +175,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -196,20 +196,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -229,7 +229,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -275,13 +275,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -292,13 +294,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -342,7 +346,7 @@ - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -359,22 +363,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -389,7 +393,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -585,7 +589,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -595,7 +599,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -603,8 +607,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -613,7 +617,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -624,11 +628,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -639,9 +643,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -651,13 +655,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -670,7 +674,7 @@ The object to serialize. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -679,9 +683,9 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -690,11 +694,11 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -711,7 +715,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -737,7 +741,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -750,14 +754,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -778,7 +782,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -799,7 +803,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -811,7 +815,7 @@ The type of the object to deserialize to. The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -823,10 +827,10 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -836,7 +840,7 @@ The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -848,10 +852,10 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -869,7 +873,7 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. @@ -880,10 +884,10 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous populate operation. + A task that represents the asynchronous population operation. @@ -891,44 +895,44 @@ Serializes the to a JSON string. The node to convert to JSON. - A JSON string of the XNode. + A JSON string of the . Serializes the to a JSON string using formatting. The node to convert to JSON. - Indicates how the output is formatted. - A JSON string of the XNode. + Indicates how the output should be formatted. + A JSON string of the . Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XNode. + A JSON string of the . Deserializes the from a JSON string. The JSON string. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -936,7 +940,7 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XNode + The deserialized . @@ -973,13 +977,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -1006,8 +1010,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -1021,7 +1025,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -1067,7 +1071,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1150,13 +1154,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -1167,13 +1173,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -1234,13 +1242,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -1266,6 +1274,105 @@ Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously skips the children of the current token. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + Specifies the state of the reader. @@ -1273,7 +1380,7 @@ - The Read method has not been called. + A read method has not been called. @@ -1308,7 +1415,7 @@ - The Close method has been called. + The method has been called. @@ -1323,7 +1430,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -1344,12 +1451,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -1358,7 +1463,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -1368,22 +1474,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -1403,7 +1509,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -1424,62 +1530,62 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -1504,20 +1610,16 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. @@ -1561,11 +1663,11 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -1591,7 +1693,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1637,8 +1739,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -1660,22 +1762,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -1721,39 +1823,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -1880,7 +1983,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -1888,33 +1991,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -1926,7 +2029,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -1950,7 +2053,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -1972,8 +2075,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -2058,7 +2161,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -2073,34 +2177,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -2126,11 +2230,101 @@ Represents a reader that provides fast, non-cached, forward-only access to JSON text data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -2139,7 +2333,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2147,55 +2341,56 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -2203,7 +2398,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -2211,7 +2406,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -2219,7 +2414,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -2227,6 +2422,585 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + Gets or sets the writer's character array pool. @@ -2234,7 +3008,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -2244,7 +3018,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -2254,18 +3028,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -2379,9 +3155,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -2391,9 +3167,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -2475,13 +3251,13 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. @@ -2492,7 +3268,7 @@ - This is returned by the if a method has not been called. + This is returned by the if a read method has not been called. @@ -2626,7 +3402,7 @@ - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -2649,59 +3425,65 @@ The specified in the constructor. + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. + A [] or null if the next JSON token is null. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2712,14 +3494,656 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + null can be passed to the method for tokens that don't have a value, e.g. . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously ets the state of the . + + The being written. + The value being written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -2740,34 +4164,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -2777,17 +4201,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -2823,13 +4249,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -2860,7 +4286,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -3021,105 +4448,105 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3142,32 +4569,32 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -3194,7 +4621,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -3217,7 +4644,7 @@ All public and private fields are serialized. Members can be excluded using or . This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. + and setting IgnoreSerializableAttribute on to false. @@ -3297,7 +4724,7 @@ Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . @@ -3446,12 +4873,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. @@ -3459,9 +4886,9 @@ Specifies type name handling options for the . - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -3489,7 +4916,7 @@ Include the .NET type name when the type of the object being serialized is not the same as its declared type. Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON you must specify a root type object with - or . + or . @@ -3501,12 +4928,12 @@ An exception has been thrown, which has left the in an invalid state. You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. + Any other method calls result in an being thrown. - The method has been called. + The method has been called. @@ -3516,7 +4943,7 @@ - A array is being written. + An array is being written. @@ -3531,7 +4958,7 @@ - A write method has not been called. + A write method has not been called. @@ -3553,12 +4980,12 @@ - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. @@ -3582,19 +5009,19 @@ Initializes a new instance of the class. - The stream. + The containing the BSON data to read. Initializes a new instance of the class. - The reader. + The containing the BSON data to read. Initializes a new instance of the class. - The stream. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. @@ -3602,13 +5029,13 @@ Initializes a new instance of the class. - The reader. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -3616,12 +5043,13 @@ - Changes the to Closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. @@ -3635,17 +5063,17 @@ Initializes a new instance of the class. - The stream. + The to write to. Initializes a new instance of the class. - The writer. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. @@ -3656,7 +5084,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -3696,7 +5124,9 @@ - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -3883,7 +5313,7 @@ - Create a custom object + Creates a custom object. The object type to convert. @@ -3977,7 +5407,7 @@ - Converts an ExpandoObject to and from JSON. + Converts an to and from JSON. @@ -4017,7 +5447,7 @@ - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). @@ -4058,7 +5488,7 @@ - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). @@ -4200,7 +5630,7 @@ - Converts a to and from a string (e.g. "1.2.3.4"). + Converts a to and from a string (e.g. "1.2.3.4"). @@ -4237,16 +5667,16 @@ - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. - The name of the deserialize root element. + The name of the deserialized root element. Gets or sets a flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - true if the array attibute is written to the XML; otherwise, false. + true if the array attribute is written to the XML; otherwise, false. @@ -4274,7 +5704,7 @@ - Checks if the attributeName is a namespace attribute. + Checks if the is a namespace attribute. Attribute name to test. The attribute name prefix if it has one, otherwise an empty string. @@ -4448,11 +5878,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -4464,6 +5894,34 @@ + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4512,7 +5970,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4531,7 +5989,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -4542,7 +6000,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -4550,7 +6008,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -4573,90 +6031,118 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. Represents a JSON constructor. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4721,18 +6207,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4802,13 +6288,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -4824,13 +6310,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -4856,13 +6342,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -4877,23 +6363,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -4931,6 +6409,37 @@ + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4973,22 +6482,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -5004,7 +6513,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -5014,11 +6523,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -5043,7 +6552,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -5057,7 +6566,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -5065,7 +6574,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -5118,7 +6627,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -5126,7 +6635,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -5152,6 +6661,35 @@ Represents a JSON property. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -5205,18 +6743,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -5224,6 +6762,15 @@ Represents a raw JSON string. + + + Asynchronously creates an instance of with the content of the reader's current token. + + The reader. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns an instance of with the content of the reader's current token. + Initializes a new instance of the class from another object. @@ -5273,7 +6820,7 @@ - Gets or sets how how null value properties are merged. + Gets or sets how null value properties are merged. How null value properties are merged. @@ -5282,6 +6829,81 @@ Represents an abstract JSON token. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Writes this token to a asynchronously. + + A into which this method will write. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + Gets a comparer that can compare two tokens for value equality. @@ -5451,8 +7073,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -5471,49 +7093,49 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5562,56 +7184,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5625,14 +7247,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5688,7 +7310,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5702,7 +7324,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5737,7 +7359,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5751,49 +7373,49 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5821,7 +7443,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5835,14 +7457,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5856,28 +7478,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5940,7 +7562,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5954,23 +7576,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -5978,25 +7600,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -6004,7 +7626,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -6014,9 +7636,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6027,9 +7649,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6047,18 +7669,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6067,9 +7689,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6081,7 +7703,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -6100,7 +7722,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -6110,7 +7732,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -6161,7 +7783,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -6203,7 +7825,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -6223,7 +7845,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6341,9 +7963,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -6358,13 +7980,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -6397,7 +8023,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -6419,7 +8045,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -6548,6 +8174,15 @@ Represents a value in JSON (string, integer, date, etc). + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + Initializes a new instance of the class from another object. @@ -6689,7 +8324,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -6708,9 +8343,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -6782,7 +8414,7 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. @@ -6910,7 +8542,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -6954,9 +8586,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -6972,15 +8604,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -7069,7 +8701,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -7111,18 +8743,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -7191,7 +8823,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7409,6 +9041,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -7433,7 +9080,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7472,7 +9119,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -7598,6 +9245,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -7649,8 +9303,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -7745,7 +9399,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -7753,12 +9407,12 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7783,11 +9437,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -7840,8 +9494,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8068,7 +9722,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -8180,7 +9834,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -8191,8 +9845,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -8224,6 +9878,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -8291,7 +9951,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -8377,9 +10037,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -8421,13 +10081,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -8458,7 +10118,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -8485,11 +10145,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -8500,8 +10160,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8545,6 +10205,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -8557,9 +10223,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -8600,7 +10273,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8608,7 +10281,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8653,6 +10326,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -8667,16 +10355,16 @@ - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -8732,17 +10420,17 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - + Helper method for generating a MetaObject which calls a specific method on Dynamic that returns a result - + Helper method for generating a MetaObject which calls a specific method on Dynamic, but uses one of the arguments for @@ -8764,7 +10452,7 @@ - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -8795,19 +10483,19 @@ Checks if value of primitive type can be assigned to parameter of primitive type . - Source primitive type - Target primitive type - True if source type can be widened to target type, false otherwise + Source primitive type. + Target primitive type. + true if source type can be widened to target type, false otherwise. Checks if a set of values with given can be used to invoke a method with specified . - Method parameters - Argument types - Try to pack extra arguments into ParamArray - True if method can be called with given arguments, false otherwise + Method parameters. + Argument types. + Try to pack extra arguments into the last parameter when it is marked up with . + true if method can be called with given arguments, false otherwise. @@ -8817,11 +10505,11 @@ - Retunrs a best method overload for given argument . + Returns a best method overload for given argument . - List of method candidates - Argument types - Best method overload, or null if none matched + List of method candidates. + Argument types. + Best method overload, or null if none matched. @@ -8894,12 +10582,12 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. @@ -8913,12 +10601,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the method is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The is used to load the assembly. diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.1/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.1/Newtonsoft.Json.dll new file mode 100644 index 000000000..e6b52ea5b Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.1/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.1/Newtonsoft.Json.xml similarity index 69% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.1/Newtonsoft.Json.xml index 1ec4a59d2..dcf508f03 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/netstandard1.1/Newtonsoft.Json.xml @@ -4,321 +4,6 @@ Newtonsoft.Json - - - Represents a BSON Oid (object id). - - - - - Gets or sets the value of the Oid. - - The value of the Oid. - - - - Initializes a new instance of the class. - - The Oid value. - - - - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. - - - - - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. - - - true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. - - - - - Gets or sets a value indicating whether the root object will be read as a JSON array. - - - true if the root object will be read as a JSON array; otherwise, false. - - - - - Gets or sets the used when reading values from BSON. - - The used when reading values from BSON. - - - - Initializes a new instance of the class. - - The stream. - - - - Initializes a new instance of the class. - - The reader. - - - - Initializes a new instance of the class. - - The stream. - if set to true the root object will be read as a JSON array. - The used when reading values from BSON. - - - - Initializes a new instance of the class. - - The reader. - if set to true the root object will be read as a JSON array. - The used when reading values from BSON. - - - - Reads the next JSON token from the stream. - - - true if the next token was read successfully; false if there are no more tokens to read. - - - - - Changes the to Closed. - - - - - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. - - - - - Gets or sets the used when writing values to BSON. - When set to no conversion will occur. - - The used when writing values to BSON. - - - - Initializes a new instance of the class. - - The stream. - - - - Initializes a new instance of the class. - - The writer. - - - - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. - - - - - Writes the end. - - The token. - - - - Writes out a comment /*...*/ containing the specified text. - - Text to place inside the comment. - - - - Writes the start of a constructor with the given name. - - The name of the constructor. - - - - Writes raw JSON. - - The raw JSON to write. - - - - Writes raw JSON where a value is expected and updates the writer's state. - - The raw JSON to write. - - - - Writes the beginning of a JSON array. - - - - - Writes the beginning of a JSON object. - - - - - Writes the property name of a name/value pair on a JSON object. - - The name of the property. - - - - Closes this stream and the underlying stream. - - - - - Writes a value. - An error will raised if the value cannot be written as a single JSON token. - - The value to write. - - - - Writes a null value. - - - - - Writes an undefined value. - - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a [] value. - - The [] value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a [] value that represents a BSON object id. - - The Object ID value to write. - - - - Writes a BSON regex. - - The regex pattern. - The regex options. - Specifies how constructors are used when initializing objects during deserialization by the . @@ -326,7 +11,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -334,446 +19,6 @@ Json.NET will use a non-public default constructor before falling back to a parameterized constructor. - - - Converts a to and from JSON and BSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Create a custom object - - The object type to convert. - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Creates an object which will then be populated by the serializer. - - Type of the object. - The created object. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Gets a value indicating whether this can write JSON. - - - true if this can write JSON; otherwise, false. - - - - - Provides a base class for converting a to and from JSON. - - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts a F# discriminated union type to and from JSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts an ExpandoObject to and from JSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Gets a value indicating whether this can write JSON. - - - true if this can write JSON; otherwise, false. - - - - - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). - - - - - Gets or sets the date time styles used when converting a date to and from JSON. - - The date time styles used when converting a date to and from JSON. - - - - Gets or sets the date time format used when converting a date to and from JSON. - - The date time format used when converting a date to and from JSON. - - - - Gets or sets the culture used when converting a date to and from JSON. - - The culture used when converting a date to and from JSON. - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing property value of the JSON that is being converted. - The calling serializer. - The object value. - - - - Converts a to and from JSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts a to and from JSON and BSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts an to and from its name string value. - - - - - Gets or sets a value indicating whether the written enum text should be camel case. - - true if the written enum text will be camel case; otherwise, false. - - - - Gets or sets a value indicating whether integer values are allowed when deserializing. - - true if integers are allowed when deserializing; otherwise, false. - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class. - - true if the written enum text will be camel case; otherwise, false. - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts a to and from a string (e.g. "1.2.3.4"). - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing property value of the JSON that is being converted. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts XML to and from JSON. - - - - - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. - - The name of the deserialize root element. - - - - Gets or sets a flag to indicate whether to write the Json.NET array attribute. - This attribute helps preserve arrays when converting the written XML back to JSON. - - true if the array attibute is written to the XML; otherwise, false. - - - - Gets or sets a value indicating whether to write the root JSON object. - - true if the JSON root object is omitted; otherwise, false. - - - - Writes the JSON representation of the object. - - The to write to. - The calling serializer. - The value. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Checks if the attributeName is a namespace attribute. - - Attribute name to test. - The attribute name prefix if it has one, otherwise an empty string. - true if attribute name is for a namespace attribute, otherwise false. - - - - Determines whether this instance can convert the specified value type. - - Type of the value. - - true if this instance can convert the specified value type; otherwise, false. - - Specifies how dates are formatted when writing JSON text. @@ -781,17 +26,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -801,12 +46,12 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -853,7 +98,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -867,7 +112,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -878,18 +123,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -930,7 +175,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -951,20 +196,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -984,7 +229,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -1030,13 +275,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -1047,13 +294,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -1097,7 +346,7 @@ - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -1114,22 +363,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -1144,7 +393,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -1340,7 +589,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -1350,7 +599,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -1358,8 +607,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -1368,7 +617,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -1379,11 +628,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -1394,9 +643,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -1406,13 +655,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -1425,7 +674,7 @@ The object to serialize. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -1434,9 +683,9 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -1445,11 +694,11 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -1466,7 +715,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1492,7 +741,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -1505,14 +754,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -1533,7 +782,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1554,7 +803,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1566,7 +815,7 @@ The type of the object to deserialize to. The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1578,10 +827,10 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1591,7 +840,7 @@ The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1603,10 +852,10 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -1624,7 +873,7 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. @@ -1635,10 +884,10 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous populate operation. + A task that represents the asynchronous population operation. @@ -1646,44 +895,44 @@ Serializes the to a JSON string. The node to convert to JSON. - A JSON string of the XNode. + A JSON string of the . Serializes the to a JSON string using formatting. The node to convert to JSON. - Indicates how the output is formatted. - A JSON string of the XNode. + Indicates how the output should be formatted. + A JSON string of the . Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XNode. + A JSON string of the . Deserializes the from a JSON string. The JSON string. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -1691,7 +940,7 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XNode + The deserialized . @@ -1728,13 +977,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -1761,8 +1010,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -1776,7 +1025,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -1822,7 +1071,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1905,13 +1154,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -1922,13 +1173,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -1989,13 +1242,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -2021,6 +1274,105 @@ Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously skips the children of the current token. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + Specifies the state of the reader. @@ -2028,7 +1380,7 @@ - The Read method has not been called. + A read method has not been called. @@ -2063,7 +1415,7 @@ - The Close method has been called. + The method has been called. @@ -2078,7 +1430,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -2099,12 +1451,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -2113,7 +1463,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -2123,22 +1474,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -2158,7 +1509,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -2179,62 +1530,62 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -2259,20 +1610,16 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. @@ -2316,11 +1663,11 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -2346,7 +1693,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -2392,8 +1739,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -2415,22 +1762,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -2476,39 +1823,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -2635,7 +1983,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -2643,33 +1991,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -2681,7 +2029,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -2705,7 +2053,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -2727,8 +2075,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -2813,7 +2161,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -2828,34 +2177,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -2881,11 +2230,101 @@ Represents a reader that provides fast, non-cached, forward-only access to JSON text data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -2894,7 +2333,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2902,55 +2341,56 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -2958,7 +2398,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -2966,7 +2406,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -2974,7 +2414,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -2982,6 +2422,585 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + Gets or sets the writer's character array pool. @@ -2989,7 +3008,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -2999,7 +3018,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -3009,18 +3028,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -3134,9 +3155,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3146,9 +3167,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3230,13 +3251,13 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. @@ -3247,7 +3268,7 @@ - This is returned by the if a method has not been called. + This is returned by the if a read method has not been called. @@ -3381,7 +3402,7 @@ - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -3404,59 +3425,65 @@ The specified in the constructor. + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. + A [] or null if the next JSON token is null. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -3467,14 +3494,656 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + null can be passed to the method for tokens that don't have a value, e.g. . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously ets the state of the . + + The being written. + The value being written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -3495,34 +4164,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -3532,17 +4201,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -3578,13 +4249,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -3615,7 +4286,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -3776,105 +4448,105 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3897,32 +4569,32 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -3949,7 +4621,1103 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. + + + + Specifies the member serialization options for the . + + + + + All public members are serialized by default. Members can be excluded using or . + This is the default member serialization mode. + + + + + Only members marked with or are serialized. + This member serialization mode can also be set by marking the class with . + + + + + All public and private fields are serialized. Members can be excluded using or . + This member serialization mode can also be set by marking the class with + and setting IgnoreSerializableAttribute on to false. + + + + + Specifies metadata property handling options for the . + + + + + Read metadata properties located at the start of a JSON object. + + + + + Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. + + + + + Do not try to read metadata properties. + + + + + Specifies missing member handling options for the . + + + + + Ignore a missing member and do not attempt to deserialize it. + + + + + Throw a when a missing member is encountered during deserialization. + + + + + Specifies null value handling options for the . + + + + + + + + + Include null values when serializing and deserializing objects. + + + + + Ignore null values when serializing and deserializing objects. + + + + + Specifies how object creation is handled by the . + + + + + Reuse existing objects, create new objects when needed. + + + + + Only reuse existing objects. + + + + + Always create new objects. + + + + + Specifies reference handling options for the . + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . + + + + + + + + Do not preserve references when serializing types. + + + + + Preserve references when serializing into a JSON object structure. + + + + + Preserve references when serializing into a JSON array structure. + + + + + Preserve references when serializing. + + + + + Specifies reference loop handling options for the . + + + + + Throw a when a loop is encountered. + + + + + Ignore loop references and do not serialize. + + + + + Serialize loop references. + + + + + Indicating whether a property is required. + + + + + The property is not required. The default state. + + + + + The property must be defined in JSON but can be a null value. + + + + + The property must be defined in JSON and cannot be a null value. + + + + + The property is not required but it cannot be a null value. + + + + + Allows users to control class loading and mandate what class to load. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object + The type of the object the formatter creates a new instance of. + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + + + + Specifies how strings are escaped when writing JSON text. + + + + + Only control characters (e.g. newline) are escaped. + + + + + All non-ASCII and control characters (e.g. newline) are escaped. + + + + + HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. + + + + + Specifies what messages to output for the class. + + + + + Output no tracing and debugging messages. + + + + + Output error-handling messages. + + + + + Output warnings and error-handling messages. + + + + + Output informational messages, warnings, and error-handling messages. + + + + + Output all debugging and tracing messages. + + + + + Indicates the method that will be used during deserialization for locating and loading assemblies. + + + + + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. + + + + + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. + + + + + Specifies type name handling options for the . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Do not include the .NET type name when serializing types. + + + + + Include the .NET type name when serializing into a JSON object structure. + + + + + Include the .NET type name when serializing into a JSON array structure. + + + + + Always include the .NET type name when serializing. + + + + + Include the .NET type name when the type of the object being serialized is not the same as its declared type. + Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON + you must specify a root type object with + or . + + + + + Specifies the state of the . + + + + + An exception has been thrown, which has left the in an invalid state. + You may call the method to put the in the Closed state. + Any other method calls result in an being thrown. + + + + + The method has been called. + + + + + An object is being written. + + + + + An array is being written. + + + + + A constructor is being written. + + + + + A property is being written. + + + + + A write method has not been called. + + + + + Represents a BSON Oid (object id). + + + + + Gets or sets the value of the Oid. + + The value of the Oid. + + + + Initializes a new instance of the class. + + The Oid value. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. + + + + + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. + + + true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. + + + + + Gets or sets a value indicating whether the root object will be read as a JSON array. + + + true if the root object will be read as a JSON array; otherwise, false. + + + + + Gets or sets the used when reading values from BSON. + + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. + + + + + Gets or sets the used when writing values to BSON. + When set to no conversion will occur. + + The used when writing values to BSON. + + + + Initializes a new instance of the class. + + The to write to. + + + + Initializes a new instance of the class. + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. + + + + + Writes the end. + + The token. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes the beginning of a JSON array. + + + + + Writes the beginning of a JSON object. + + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value that represents a BSON object id. + + The Object ID value to write. + + + + Writes a BSON regex. + + The regex pattern. + The regex options. + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Creates a custom object. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Creates an object which will then be populated by the serializer. + + Type of the object. + The created object. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Provides a base class for converting a to and from JSON. + + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a F# discriminated union type to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). + + + + + Gets or sets the date time styles used when converting a date to and from JSON. + + The date time styles used when converting a date to and from JSON. + + + + Gets or sets the date time format used when converting a date to and from JSON. + + The date time format used when converting a date to and from JSON. + + + + Gets or sets the culture used when converting a date to and from JSON. + + The culture used when converting a date to and from JSON. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from its name string value. + + + + + Gets or sets a value indicating whether the written enum text should be camel case. + + true if the written enum text will be camel case; otherwise, false. + + + + Gets or sets a value indicating whether integer values are allowed when deserializing. + + true if integers are allowed when deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + true if the written enum text will be camel case; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from a string (e.g. "1.2.3.4"). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts XML to and from JSON. + + + + + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. + + The name of the deserialized root element. + + + + Gets or sets a flag to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + true if the array attribute is written to the XML; otherwise, false. + + + + Gets or sets a value indicating whether to write the root JSON object. + + true if the JSON root object is omitted; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The calling serializer. + The value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Checks if the is a namespace attribute. + + Attribute name to test. + The attribute name prefix if it has one, otherwise an empty string. + true if attribute name is for a namespace attribute, otherwise false. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + @@ -4110,11 +5878,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -4126,6 +5894,34 @@ + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4174,7 +5970,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4193,7 +5989,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -4204,7 +6000,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -4212,7 +6008,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -4235,90 +6031,118 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. Represents a JSON constructor. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4383,18 +6207,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4464,13 +6288,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -4486,13 +6310,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -4518,13 +6342,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -4539,23 +6363,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -4593,6 +6409,37 @@ + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4635,22 +6482,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -4666,7 +6513,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -4676,11 +6523,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -4705,7 +6552,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -4719,7 +6566,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -4727,7 +6574,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -4780,7 +6627,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -4788,7 +6635,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -4814,6 +6661,35 @@ Represents a JSON property. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + Gets the container's children tokens. @@ -4867,18 +6743,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4886,6 +6762,15 @@ Represents a raw JSON string. + + + Asynchronously creates an instance of with the content of the reader's current token. + + The reader. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns an instance of with the content of the reader's current token. + Initializes a new instance of the class from another object. @@ -4935,7 +6820,7 @@ - Gets or sets how how null value properties are merged. + Gets or sets how null value properties are merged. How null value properties are merged. @@ -4944,6 +6829,81 @@ Represents an abstract JSON token. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Writes this token to a asynchronously. + + A into which this method will write. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + Gets a comparer that can compare two tokens for value equality. @@ -5113,8 +7073,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -5133,49 +7093,49 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5224,56 +7184,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5287,14 +7247,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5350,7 +7310,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5364,7 +7324,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5399,7 +7359,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5413,49 +7373,49 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5483,7 +7443,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5497,14 +7457,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5518,28 +7478,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5602,7 +7562,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5616,23 +7576,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -5640,25 +7600,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -5666,7 +7626,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -5676,9 +7636,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5689,9 +7649,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5709,18 +7669,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5729,9 +7689,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5743,7 +7703,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -5762,7 +7722,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -5772,7 +7732,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -5823,7 +7783,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -5865,7 +7825,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -5885,7 +7845,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6003,9 +7963,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -6020,13 +7980,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -6059,7 +8023,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -6081,7 +8045,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -6210,6 +8174,15 @@ Represents a value in JSON (string, integer, date, etc). + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + Initializes a new instance of the class from another object. @@ -6351,7 +8324,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -6370,9 +8343,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -6444,7 +8414,7 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. @@ -6479,178 +8449,6 @@ The content's null value properties will be merged. - - - Specifies the member serialization options for the . - - - - - All public members are serialized by default. Members can be excluded using or . - This is the default member serialization mode. - - - - - Only members marked with or are serialized. - This member serialization mode can also be set by marking the class with . - - - - - All public and private fields are serialized. Members can be excluded using or . - This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. - - - - - Specifies metadata property handling options for the . - - - - - Read metadata properties located at the start of a JSON object. - - - - - Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. - - - - - Do not try to read metadata properties. - - - - - Specifies missing member handling options for the . - - - - - Ignore a missing member and do not attempt to deserialize it. - - - - - Throw a when a missing member is encountered during deserialization. - - - - - Specifies null value handling options for the . - - - - - - - - - Include null values when serializing and deserializing objects. - - - - - Ignore null values when serializing and deserializing objects. - - - - - Specifies how object creation is handled by the . - - - - - Reuse existing objects, create new objects when needed. - - - - - Only reuse existing objects. - - - - - Always create new objects. - - - - - Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. - - - - - - - - Do not preserve references when serializing types. - - - - - Preserve references when serializing into a JSON object structure. - - - - - Preserve references when serializing into a JSON array structure. - - - - - Preserve references when serializing. - - - - - Specifies reference loop handling options for the . - - - - - Throw a when a loop is encountered. - - - - - Ignore loop references and do not serialize. - - - - - Serialize loop references. - - - - - Indicating whether a property is required. - - - - - The property is not required. The default state. - - - - - The property must be defined in JSON but can be a null value. - - - - - The property must be defined in JSON and cannot be a null value. - - - - - The property is not required but it cannot be a null value. - - @@ -6744,7 +8542,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -6788,9 +8586,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -6806,15 +8604,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -6903,7 +8701,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -6945,18 +8743,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -7025,7 +8823,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7226,27 +9024,6 @@ - - - Allows users to control class loading and mandate what class to load. - - - - - When overridden in a derived class, controls the binding of a serialized object to a type. - - Specifies the name of the serialized object. - Specifies the name of the serialized object - The type of the object the formatter creates a new instance of. - - - - When overridden in a derived class, controls the binding of a serialized object to a type. - - The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. - A camel case naming strategy. @@ -7264,6 +9041,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -7286,46 +9078,9 @@ Initializes a new instance of the class. - - - The default naming strategy. Property names and dictionary keys are unchanged. - - - - - Resolves the specified property name. - - The property name to resolve. - The resolved property name. - - - - Get and set values for a using dynamic methods. - - - - - Initializes a new instance of the class. - - The member info. - - - - Sets the value. - - The target to set the value on. - The value to set on the target. - - - - Gets the value. - - The target to get the value from. - The value. - - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7364,7 +9119,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -7490,6 +9245,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -7504,6 +9266,18 @@ Name of the property. Name of the property. + + + The default naming strategy. Property names and dictionary keys are unchanged. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + The default serialization binder used when resolving and loading classes from type names. @@ -7529,8 +9303,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -7591,6 +9365,31 @@ The current object. The error context. + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + Provides methods to get attributes. @@ -7600,7 +9399,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -7608,12 +9407,12 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7638,11 +9437,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -7695,8 +9494,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -7923,7 +9722,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -8035,7 +9834,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -8046,8 +9845,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -8079,6 +9878,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -8146,7 +9951,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -8232,9 +10037,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -8276,13 +10081,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -8313,7 +10118,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -8340,11 +10145,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -8355,8 +10160,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8400,6 +10205,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -8412,9 +10223,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -8455,7 +10273,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8463,7 +10281,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8508,6 +10326,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -8520,121 +10353,18 @@ The property name to resolve. The resolved property name. - - - Specifies how strings are escaped when writing JSON text. - - - - - Only control characters (e.g. newline) are escaped. - - - - - All non-ASCII and control characters (e.g. newline) are escaped. - - - - - HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. - - - - - Specifies what messages to output for the class. - - - - - Output no tracing and debugging messages. - - - - - Output error-handling messages. - - - - - Output warnings and error-handling messages. - - - - - Output informational messages, warnings, and error-handling messages. - - - - - Output all debugging and tracing messages. - - - - - Indicates the method that will be used during deserialization for locating and loading assemblies. - - - - - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. - - - - - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. - - - - - Specifies type name handling options for the . - - - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. - - - - - Do not include the .NET type name when serializing types. - - - - - Include the .NET type name when serializing into a JSON object structure. - - - - - Include the .NET type name when serializing into a JSON array structure. - - - - - Always include the .NET type name when serializing. - - - - - Include the .NET type name when the type of the object being serialized is not the same as its declared type. - Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON - you must specify a root type object with - or . - - - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -8690,17 +10420,17 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - + Helper method for generating a MetaObject which calls a specific method on Dynamic that returns a result - + Helper method for generating a MetaObject which calls a specific method on Dynamic, but uses one of the arguments for @@ -8722,7 +10452,7 @@ - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -8753,19 +10483,19 @@ Checks if value of primitive type can be assigned to parameter of primitive type . - Source primitive type - Target primitive type - True if source type can be widened to target type, false otherwise + Source primitive type. + Target primitive type. + true if source type can be widened to target type, false otherwise. Checks if a set of values with given can be used to invoke a method with specified . - Method parameters - Argument types - Try to pack extra arguments into ParamArray - True if method can be called with given arguments, false otherwise + Method parameters. + Argument types. + Try to pack extra arguments into the last parameter when it is marked up with . + true if method can be called with given arguments, false otherwise. @@ -8775,11 +10505,11 @@ - Retunrs a best method overload for given argument . + Returns a best method overload for given argument . - List of method candidates - Argument types - Best method overload, or null if none matched + List of method candidates. + Argument types. + Best method overload, or null if none matched. @@ -8852,60 +10582,18 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. true if the string is all white space; otherwise, false. - - - Specifies the state of the . - - - - - An exception has been thrown, which has left the in an invalid state. - You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. - - - - - The method has been called. - - - - - An object is being written. - - - - - A array is being written. - - - - - A constructor is being written. - - - - - A property is being written. - - - - - A write method has not been called. - - Indicates the method that will be used during deserialization for locating and loading assemblies. @@ -8913,12 +10601,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the method is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The is used to load the assembly. diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.dll new file mode 100644 index 000000000..9c95023ac Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.xml similarity index 90% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.xml index 8af965aea..434248a5d 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net40+sl5+wp80+win8+wpa81/Newtonsoft.Json.xml @@ -23,12 +23,12 @@ - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. @@ -52,19 +52,19 @@ Initializes a new instance of the class. - The stream. + The containing the BSON data to read. Initializes a new instance of the class. - The reader. + The containing the BSON data to read. Initializes a new instance of the class. - The stream. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. @@ -72,13 +72,13 @@ Initializes a new instance of the class. - The reader. + The containing the BSON data to read. if set to true the root object will be read as a JSON array. The used when reading values from BSON. - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -86,12 +86,13 @@ - Changes the to Closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. @@ -105,17 +106,17 @@ Initializes a new instance of the class. - The stream. + The to write to. Initializes a new instance of the class. - The writer. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. @@ -126,7 +127,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -166,7 +167,9 @@ - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -326,7 +329,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -368,7 +371,7 @@ - Create a custom object + Creates a custom object. The object type to convert. @@ -462,7 +465,7 @@ - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). @@ -503,7 +506,7 @@ - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). @@ -645,7 +648,7 @@ - Converts a to and from a string (e.g. "1.2.3.4"). + Converts a to and from a string (e.g. "1.2.3.4"). @@ -682,17 +685,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -702,12 +705,12 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -754,7 +757,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -768,7 +771,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -779,18 +782,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -831,7 +834,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -852,20 +855,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -885,7 +888,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -931,13 +934,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -948,13 +953,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -998,7 +1005,7 @@ - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -1015,22 +1022,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -1045,7 +1052,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -1241,7 +1248,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -1251,7 +1258,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -1259,8 +1266,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -1269,7 +1276,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -1280,11 +1287,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -1295,9 +1302,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -1307,13 +1314,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -1333,7 +1340,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1359,7 +1366,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -1372,14 +1379,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -1400,7 +1407,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1421,7 +1428,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -1440,7 +1447,7 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. @@ -1478,13 +1485,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -1511,8 +1518,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -1526,7 +1533,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -1572,7 +1579,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1655,13 +1662,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -1672,13 +1681,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -1739,13 +1750,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -1778,7 +1789,7 @@ - The Read method has not been called. + A read method has not been called. @@ -1813,7 +1824,7 @@ - The Close method has been called. + The method has been called. @@ -1828,7 +1839,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -1849,12 +1860,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -1863,7 +1872,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -1873,22 +1883,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -1908,7 +1918,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -1929,62 +1939,62 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -2009,20 +2019,16 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. @@ -2066,11 +2072,11 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -2096,7 +2102,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -2142,8 +2148,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -2165,22 +2171,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -2226,39 +2232,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -2385,7 +2392,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -2393,33 +2400,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -2431,7 +2438,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -2455,7 +2462,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -2477,8 +2484,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -2563,7 +2570,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -2578,34 +2586,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -2633,9 +2641,9 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -2644,7 +2652,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2652,55 +2660,56 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -2708,7 +2717,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -2716,7 +2725,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -2724,7 +2733,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -2739,7 +2748,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -2749,7 +2758,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -2759,18 +2768,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -2884,9 +2895,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -2896,9 +2907,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -2980,13 +2991,13 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. @@ -2997,7 +3008,7 @@ - This is returned by the if a method has not been called. + This is returned by the if a read method has not been called. @@ -3131,7 +3142,7 @@ - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -3154,59 +3165,65 @@ The specified in the constructor. + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. + A [] or null if the next JSON token is null. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . + A of . - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -3219,12 +3236,18 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -3245,34 +3268,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -3282,17 +3305,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -3328,13 +3353,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -3365,7 +3390,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -3526,105 +3552,105 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3647,32 +3673,32 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -3699,7 +3725,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -3860,11 +3886,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -3924,7 +3950,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -3943,7 +3969,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -3954,7 +3980,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -3962,7 +3988,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -3985,84 +4011,81 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. @@ -4133,18 +4156,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4203,13 +4226,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -4225,13 +4248,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -4257,13 +4280,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -4278,23 +4301,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -4374,22 +4389,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -4405,7 +4420,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -4415,11 +4430,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -4444,7 +4459,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -4458,7 +4473,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -4466,7 +4481,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -4519,7 +4534,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -4527,7 +4542,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -4597,18 +4612,18 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4665,7 +4680,7 @@ - Gets or sets how how null value properties are merged. + Gets or sets how null value properties are merged. How null value properties are merged. @@ -4843,8 +4858,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -4863,49 +4878,49 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -4954,56 +4969,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5017,14 +5032,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5080,7 +5095,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5094,7 +5109,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5129,7 +5144,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5143,49 +5158,49 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5213,7 +5228,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5227,14 +5242,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5248,28 +5263,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5332,7 +5347,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5346,23 +5361,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -5370,25 +5385,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -5396,7 +5411,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -5406,9 +5421,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5419,9 +5434,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5439,18 +5454,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5459,9 +5474,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -5473,7 +5488,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -5492,7 +5507,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -5502,7 +5517,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -5535,7 +5550,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -5577,7 +5592,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -5597,7 +5612,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -5715,9 +5730,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -5732,13 +5747,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -5771,7 +5790,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -5793,7 +5812,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -6063,7 +6082,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -6082,9 +6101,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -6147,7 +6163,7 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. @@ -6203,7 +6219,7 @@ All public and private fields are serialized. Members can be excluded using or . This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. + and setting IgnoreSerializableAttribute on to false. @@ -6283,7 +6299,7 @@ Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . @@ -6447,7 +6463,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -6491,9 +6507,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -6509,15 +6525,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -6606,7 +6622,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -6648,18 +6664,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -6728,7 +6744,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -6967,6 +6983,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -6991,7 +7022,7 @@ - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7036,7 +7067,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -7155,6 +7186,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -7206,8 +7244,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -7302,7 +7340,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -7310,12 +7348,12 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7340,11 +7378,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -7397,8 +7435,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -7625,7 +7663,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -7714,7 +7752,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -7725,8 +7763,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -7758,6 +7796,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -7825,7 +7869,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -7911,9 +7955,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -7955,13 +7999,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -7992,7 +8036,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -8019,11 +8063,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -8034,8 +8078,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8079,6 +8123,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -8091,9 +8141,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -8134,7 +8191,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8142,7 +8199,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8187,6 +8244,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -8256,12 +8328,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. @@ -8269,9 +8341,9 @@ Specifies type name handling options for the . - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -8299,21 +8371,21 @@ Include the .NET type name when the type of the object being serialized is not the same as its declared type. Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON you must specify a root type object with - or . + or . - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -8369,13 +8441,13 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -8457,12 +8529,12 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. @@ -8478,12 +8550,12 @@ An exception has been thrown, which has left the in an invalid state. You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. + Any other method calls result in an being thrown. - The method has been called. + The method has been called. @@ -8493,7 +8565,7 @@ - A array is being written. + An array is being written. @@ -8508,7 +8580,7 @@ - A write method has not been called. + A write method has not been called. @@ -8518,12 +8590,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the method is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The is used to load the assembly. diff --git a/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.dll b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.dll new file mode 100644 index 000000000..90856dbd8 Binary files /dev/null and b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.dll differ diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.1/Newtonsoft.Json.xml b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.xml similarity index 69% rename from packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.1/Newtonsoft.Json.xml rename to packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.xml index 74c186c97..617be97d2 100644 --- a/packages/Newtonsoft.Json.9.0.2-beta1/lib/netstandard1.1/Newtonsoft.Json.xml +++ b/packages/Newtonsoft.Json.9.0.2-beta2/lib/portable-net45+wp80+win8+wpa81/Newtonsoft.Json.xml @@ -4,6 +4,324 @@ Newtonsoft.Json + + + Represents a BSON Oid (object id). + + + + + Gets or sets the value of the Oid. + + The value of the Oid. + + + + Initializes a new instance of the class. + + The Oid value. + + + + Represents a reader that provides fast, non-cached, forward-only access to serialized BSON data. + + + + + Gets or sets a value indicating whether binary data reading should be compatible with incorrect Json.NET 3.5 written binary. + + + true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. + + + + + Gets or sets a value indicating whether the root object will be read as a JSON array. + + + true if the root object will be read as a JSON array; otherwise, false. + + + + + Gets or sets the used when reading values from BSON. + + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Initializes a new instance of the class. + + The containing the BSON data to read. + if set to true the root object will be read as a JSON array. + The used when reading values from BSON. + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Represents a writer that provides a fast, non-cached, forward-only way of generating BSON data. + + + + + Gets or sets the used when writing values to BSON. + When set to no conversion will occur. + + The used when writing values to BSON. + + + + Initializes a new instance of the class. + + The to write to. + + + + Initializes a new instance of the class. + + The to write to. + + + + Flushes whatever is in the buffer to the underlying and also flushes the underlying stream. + + + + + Writes the end. + + The token. + + + + Writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + + + + Writes the start of a constructor with the given name. + + The name of the constructor. + + + + Writes raw JSON. + + The raw JSON to write. + + + + Writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + + + + Writes the beginning of a JSON array. + + + + + Writes the beginning of a JSON object. + + + + + Writes the property name of a name/value pair on a JSON object. + + The name of the property. + + + + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. + + + + + Writes a value. + An error will raised if the value cannot be written as a single JSON token. + + The value to write. + + + + Writes a null value. + + + + + Writes an undefined value. + + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value. + + The [] value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a value. + + The value to write. + + + + Writes a [] value that represents a BSON object id. + + The Object ID value to write. + + + + Writes a BSON regex. + + The regex pattern. + The regex options. + Specifies how constructors are used when initializing objects during deserialization by the . @@ -11,7 +329,7 @@ - First attempt to use the public default constructor, then fall back to single parameterized constructor, then the non-public default constructor. + First attempt to use the public default constructor, then fall back to a single parameterized constructor, then to the non-public default constructor. @@ -19,6 +337,446 @@ Json.NET will use a non-public default constructor before falling back to a parameterized constructor. + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Creates a custom object. + + The object type to convert. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Creates an object which will then be populated by the serializer. + + Type of the object. + The created object. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Provides a base class for converting a to and from JSON. + + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a F# discriminated union type to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Gets a value indicating whether this can write JSON. + + + true if this can write JSON; otherwise, false. + + + + + Converts a to and from the ISO 8601 date format (e.g. "2008-04-12T12:53Z"). + + + + + Gets or sets the date time styles used when converting a date to and from JSON. + + The date time styles used when converting a date to and from JSON. + + + + Gets or sets the date time format used when converting a date to and from JSON. + + The date time format used when converting a date to and from JSON. + + + + Gets or sets the culture used when converting a date to and from JSON. + + The culture used when converting a date to and from JSON. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Converts a to and from a JavaScript Date constructor (e.g. new Date(52231943)). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Converts a to and from JSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from JSON and BSON. + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts an to and from its name string value. + + + + + Gets or sets a value indicating whether the written enum text should be camel case. + + true if the written enum text will be camel case; otherwise, false. + + + + Gets or sets a value indicating whether integer values are allowed when deserializing. + + true if integers are allowed when deserializing; otherwise, false. + + + + Initializes a new instance of the class. + + + + + Initializes a new instance of the class. + + true if the written enum text will be camel case; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts a to and from a string (e.g. "1.2.3.4"). + + + + + Writes the JSON representation of the object. + + The to write to. + The value. + The calling serializer. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing property value of the JSON that is being converted. + The calling serializer. + The object value. + + + + Determines whether this instance can convert the specified object type. + + Type of the object. + + true if this instance can convert the specified object type; otherwise, false. + + + + + Converts XML to and from JSON. + + + + + Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produced multiple root elements. + + The name of the deserialized root element. + + + + Gets or sets a flag to indicate whether to write the Json.NET array attribute. + This attribute helps preserve arrays when converting the written XML back to JSON. + + true if the array attribute is written to the XML; otherwise, false. + + + + Gets or sets a value indicating whether to write the root JSON object. + + true if the JSON root object is omitted; otherwise, false. + + + + Writes the JSON representation of the object. + + The to write to. + The calling serializer. + The value. + + + + Reads the JSON representation of the object. + + The to read from. + Type of the object. + The existing value of object being read. + The calling serializer. + The object value. + + + + Checks if the is a namespace attribute. + + Attribute name to test. + The attribute name prefix if it has one, otherwise an empty string. + true if attribute name is for a namespace attribute, otherwise false. + + + + Determines whether this instance can convert the specified value type. + + Type of the value. + + true if this instance can convert the specified value type; otherwise, false. + + Specifies how dates are formatted when writing JSON text. @@ -26,17 +784,17 @@ - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". - Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. + Specifies how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON text. @@ -46,12 +804,12 @@ - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . + Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to . @@ -98,7 +856,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - so that is is not written to JSON. + so that it is not written to JSON. This option will ignore all default values (e.g. null for objects and nullable types; 0 for integers, decimals and floating point numbers; and false for booleans). The default value ignored can be changed by placing the on the property. @@ -112,7 +870,7 @@ Ignore members where the member value is the same as the member's default value when serializing objects - and sets members to their default value when deserializing. + and set members to their default value when deserializing. @@ -123,18 +881,18 @@ - Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". + Write special floating point values as strings in JSON, e.g. "NaN", "Infinity", "-Infinity". - Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. + Write special floating point values as symbols in JSON, e.g. NaN, Infinity, -Infinity. Note that this will produce non-valid JSON. - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a property, null for a of property. @@ -175,7 +933,7 @@ - Rent a array from the pool. This array must be returned when it is no longer needed. + Rent an array from the pool. This array must be returned when it is no longer needed. The minimum required length of the array. The returned array may be longer. The rented array from the pool. This array must be returned when it is no longer needed. @@ -196,20 +954,20 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, when returns false). Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, when returns false). @@ -229,7 +987,7 @@ - Initializes a new instance of the class with a flag indicating whether the array can contain null items + Initializes a new instance of the class with a flag indicating whether the array can contain null items. A flag indicating whether the array can contain null items. @@ -275,13 +1033,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -292,13 +1052,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -342,7 +1104,7 @@ - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. @@ -359,22 +1121,22 @@ - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value true as a string. This field is read-only. - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value false as a string. This field is read-only. - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's null as a string. This field is read-only. - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's undefined as a string. This field is read-only. @@ -389,7 +1151,7 @@ - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's NaN as a string. This field is read-only. @@ -585,7 +1347,7 @@ Serializes the specified object to a JSON string using formatting. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. A JSON string representation of the object. @@ -595,7 +1357,7 @@ Serializes the specified object to a JSON string using a collection of . The object to serialize. - A collection converters used while serializing. + A collection of converters used while serializing. A JSON string representation of the object. @@ -603,8 +1365,8 @@ Serializes the specified object to a JSON string using formatting and a collection of . The object to serialize. - Indicates how the output is formatted. - A collection converters used while serializing. + Indicates how the output should be formatted. + A collection of converters used while serializing. A JSON string representation of the object. @@ -613,7 +1375,7 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -624,11 +1386,11 @@ The object to serialize. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -639,9 +1401,9 @@ Serializes the specified object to a JSON string using formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. A JSON string representation of the object. @@ -651,13 +1413,13 @@ Serializes the specified object to a JSON string using a type, formatting and . The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. A JSON string representation of the object. @@ -670,7 +1432,7 @@ The object to serialize. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -679,9 +1441,9 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -690,11 +1452,11 @@ Serialization will happen on a new thread. The object to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. The used to serialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. @@ -711,7 +1473,7 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -737,7 +1499,7 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. @@ -750,14 +1512,14 @@ The anonymous type to deserialize to. This can't be specified - traditionally and must be infered from the anonymous type passed + traditionally and must be inferred from the anonymous type passed as a parameter. The JSON to deserialize. The anonymous type object. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized anonymous type from the JSON string. @@ -778,7 +1540,7 @@ The object to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -799,7 +1561,7 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. The deserialized object from the JSON string. @@ -811,7 +1573,7 @@ The type of the object to deserialize to. The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -823,10 +1585,10 @@ The JSON to deserialize. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -836,7 +1598,7 @@ The JSON to deserialize. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -848,10 +1610,10 @@ The type of the object to deserialize to. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous deserialize operation. The value of the TResult parameter contains the deserialized object from the JSON string. + A task that represents the asynchronous deserialization operation. The value of the TResult parameter contains the deserialized object from the JSON string. @@ -869,7 +1631,7 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. @@ -880,10 +1642,10 @@ The target object to populate values onto. The used to deserialize the object. - If this is null, default serialization settings will be used. + If this is null, default serialization settings will be used. - A task that represents the asynchronous populate operation. + A task that represents the asynchronous population operation. @@ -891,44 +1653,44 @@ Serializes the to a JSON string. The node to convert to JSON. - A JSON string of the XNode. + A JSON string of the . Serializes the to a JSON string using formatting. The node to convert to JSON. - Indicates how the output is formatted. - A JSON string of the XNode. + Indicates how the output should be formatted. + A JSON string of the . Serializes the to a JSON string using formatting and omits the root object if is true. The node to serialize. - Indicates how the output is formatted. + Indicates how the output should be formatted. Omits writing the root object. - A JSON string of the XNode. + A JSON string of the . Deserializes the from a JSON string. The JSON string. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by . + Deserializes the from a JSON string nested in a root element specified by . The JSON string. The name of the root element to append when deserializing. - The deserialized XNode + The deserialized . - Deserializes the from a JSON string nested in a root elment specified by - and writes a .NET array attribute for collections. + Deserializes the from a JSON string nested in a root element specified by + and writes a Json.NET array attribute for collections. The JSON string. The name of the root element to append when deserializing. @@ -936,7 +1698,7 @@ A flag to indicate whether to write the Json.NET array attribute. This attribute helps preserve arrays when converting the written XML back to JSON. - The deserialized XNode + The deserialized . @@ -973,13 +1735,13 @@ - Gets the of the JSON produced by the JsonConverter. + Gets the of the JSON produced by the . JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - The of the JSON produced by the JsonConverter. + The of the JSON produced by the . @@ -1006,8 +1768,8 @@ - The parameter list to use when constructing the described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the described by . + If null, the default constructor is used. @@ -1021,7 +1783,7 @@ Initializes a new instance of the class. Type of the . - Parameter list to use when constructing the . Can be null. + Parameter list to use when constructing the . Can be null. @@ -1067,7 +1829,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1150,13 +1912,15 @@ - The parameter list to use when constructing the described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + @@ -1167,13 +1931,15 @@ - The parameter list to use when constructing the described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the that exactly matches the number, + The parameter list to use when constructing the described by . + If null, the default constructor is used. + When non-null, there must be a constructor defined in the that exactly matches the number, order, and type of these parameters. + [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + @@ -1234,13 +2000,13 @@ - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. @@ -1266,6 +2032,105 @@ Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously skips the children of the current token. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + Specifies the state of the reader. @@ -1273,7 +2138,7 @@ - The Read method has not been called. + A read method has not been called. @@ -1308,7 +2173,7 @@ - The Close method has been called. + The method has been called. @@ -1323,7 +2188,7 @@ - Reader in a constructor. + Reader is in a constructor. @@ -1344,12 +2209,10 @@ - Gets or sets a value indicating whether the underlying stream or - should be closed when the reader is closed. + Gets or sets a value indicating whether the source should be closed when this reader is closed. - true to close the underlying stream or when - the reader is closed; otherwise false. The default is true. + true to close the source when this reader is closed; otherwise false. The default is true. @@ -1358,7 +2221,8 @@ be read from a continuous stream without erroring. - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + true to support reading multiple pieces of JSON content; otherwise false. + The default is false. @@ -1368,22 +2232,22 @@ - Get or set how time zones are handling when reading JSON. + Gets or sets how time zones are handled when reading JSON. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how custom date formatted strings are parsed when reading JSON. + Gets or sets how custom date formatted strings are parsed when reading JSON. @@ -1403,7 +2267,7 @@ - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. @@ -1424,62 +2288,62 @@ - Initializes a new instance of the class with the specified . + Initializes a new instance of the class. - Reads the next JSON token from the stream. + Reads the next JSON token from the source. true if the next token was read successfully; false if there are no more tokens to read. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the source as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the source as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. @@ -1504,20 +2368,16 @@ Sets the state based on current token type. - - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - - - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Changes the to Closed. + Changes the reader's state to . + If is set to true, the source is also closed. @@ -1561,11 +2421,11 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. - Instructs the to always serialize the member, and require the member has a value. + Instructs the to always serialize the member, and to require that the member has a value. @@ -1591,7 +2451,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -1637,8 +2497,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . @@ -1660,22 +2520,22 @@ - Get or set how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) is handled. - Get or set how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. @@ -1721,39 +2581,40 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -1880,7 +2741,7 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -1888,33 +2749,33 @@ Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. - This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + This parameter is used when is to write out the type name if the type of the value does not match. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. The type of the value being serialized. This parameter is used when is Auto to write out the type name if the type of the value does not match. - Specifing the type is optional. + Specifying the type is optional. Serializes the specified and writes the JSON structure - to a Stream using the specified . + using the specified . The used to write the JSON structure. The to serialize. @@ -1926,7 +2787,7 @@ - Gets or sets how reference loops (e.g. a class referencing itself) is handled. + Gets or sets how reference loops (e.g. a class referencing itself) are handled. Reference loop handling. @@ -1950,7 +2811,7 @@ - Gets or sets how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. The default value handling. @@ -1972,8 +2833,8 @@ should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. + Incoming types should be validated with a custom + when deserializing with a value other than . The type name handling. @@ -2058,7 +2919,8 @@ - Get or set how and values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how and values are formatted when writing JSON text, + and the expected date format when reading JSON text. @@ -2073,34 +2935,34 @@ - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling during serialization and deserialization. + Gets or sets how time zones are handled during serialization and deserialization. - Get or set how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. + Gets or sets how date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed when reading JSON. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written as JSON. - Get or set how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + Gets or sets how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. @@ -2126,11 +2988,101 @@ Represents a reader that provides fast, non-cached, forward-only access to JSON text data. + + + Asynchronously reads the next JSON token from the source. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns true if the next token was read successfully; false if there are no more tokens to read. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a []. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the []. This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a of . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the of . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously reads the next JSON token from the source as a . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous read. The + property returns the . This result will be null at the end of an array. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + - Initializes a new instance of the class with the specified . + Initializes a new instance of the class with the specified . - The TextReader containing the XML data to read. + The containing the JSON data to read. @@ -2139,7 +3091,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -2147,55 +3099,56 @@ - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a . A . This method will return null at the end of an array. - Reads the next JSON token from the stream as a []. + Reads the next JSON token from the underlying as a []. - A [] or a null reference if the next JSON token is null. This method will return null at the end of an array. + A [] or null if the next JSON token is null. This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Reads the next JSON token from the stream as a . + Reads the next JSON token from the underlying as a of . - A . This method will return null at the end of an array. + A of . This method will return null at the end of an array. - Changes the state to closed. + Changes the reader's state to . + If is set to true, the underlying is also closed. @@ -2203,7 +3156,7 @@ Gets a value indicating whether the class can return line information. - true if LineNumber and LinePosition can be provided; otherwise, false. + true if and can be provided; otherwise, false. @@ -2211,7 +3164,7 @@ Gets the current line number. - The current line number or 0 if no line information is available (for example, HasLineInfo returns false). + The current line number or 0 if no line information is available (for example, returns false). @@ -2219,7 +3172,7 @@ Gets the current line position. - The current line position or 0 if no line information is available (for example, HasLineInfo returns false). + The current line position or 0 if no line information is available (for example, returns false). @@ -2227,6 +3180,585 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task. + Gets or sets the writer's character array pool. @@ -2234,7 +3766,7 @@ - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to Formatting.Indented. + Gets or sets how many s to write for each level in the hierarchy when is set to . @@ -2244,7 +3776,7 @@ - Gets or sets which character to use for indenting when is set to Formatting.Indented. + Gets or sets which character to use for indenting when is set to . @@ -2254,18 +3786,20 @@ - Creates an instance of the JsonWriter class using the specified . + Initializes a new instance of the class using the specified . - The TextWriter to write to. + The to write to. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying and also flushes the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the underlying is also closed. + If is set to true, the JSON is auto-completed. @@ -2379,9 +3913,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -2391,9 +3925,9 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -2475,251 +4009,671 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - - - Specifies the type of JSON token. - - - - - This is returned by the if a method has not been called. - - - - - An object start token. - - - - - An array start token. - - - - - A constructor start token. - - - - - An object property name. - - - - - A comment. - - - - - Raw JSON. - - - - - An integer. - - - - - A float. - - - - - A string. - - - - - A boolean. - - - - - A null token. - - - - - An undefined token. - - - - - An object end token. - - - - - An array end token. - - - - - A constructor end token. - - - - - A Date. - - - - - Byte data. - - - - - - Represents a reader that provides validation. - - - JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. - - - - - - Sets an event handler for receiving schema validation errors. - - - - - Gets the text value of the current JSON token. - - - - - - Gets the depth of the current token in the JSON document. - - The depth of the current token in the JSON document. - - - - Gets the path of the current JSON token. - - - - - Gets the quotation mark character used to enclose the value of a string. - - - - - - Gets the type of the current JSON token. - - - - - - Gets the Common Language Runtime (CLR) type for the current JSON token. - - - - - - Initializes a new instance of the class that - validates the content returned from the given . - - The to read from while validating. - - - - Gets or sets the schema. - - The schema. - - - - Gets the used to construct this . - - The specified in the constructor. - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream as a []. - - - A [] or a null reference if the next JSON token is null. - - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . This method will return null at the end of an array. - - - - Reads the next JSON token from the stream as a . - - A . - - - - Reads the next JSON token from the stream. - - - true if the next token was read successfully; false if there are no more tokens to read. - - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. + + + Asynchronously closes this writer. + If is set to true, the destination is also closed. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the specified end token. + + The end token to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes indent characters. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the JSON value delimiter. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an indent space. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON without changing the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of the current JSON object or array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of an array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a constructor. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the end of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a null value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the property name of a name/value pair of a JSON object. + + The name of the property. + A flag to indicate whether the text should be escaped when it is written as a JSON property name. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON array. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a comment /*...*/ containing the specified text. + + Text to place inside the comment. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + + The raw JSON to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the start of a constructor with the given name. + + The name of the constructor. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the beginning of a JSON object. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the current token. + + The to read the token from. + A flag indicating whether the current token's children should be written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the token and its value. + + The to write. + + The value to write. + A value is only required for tokens that have an associated value, e.g. the property name for . + null can be passed to the method for tokens that don't have a value, e.g. . + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a [] value. + + The [] value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a value. + + The value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes a of value. + + The of value to write. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes an undefined value. + + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously writes the given white space. + + The string of white space characters. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + + + + Asynchronously ets the state of the . + + The being written. + The value being written. + The token to monitor for cancellation requests. The default value is . + A that represents the asynchronous operation. + The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asychronousity. + - Gets or sets a value indicating whether the underlying stream or - should be closed when the writer is closed. + Gets or sets a value indicating whether the destination should be closed when this writer is closed. - true to close the underlying stream or when - the writer is closed; otherwise false. The default is true. + true to close the destination when this writer is closed; otherwise false. The default is true. + + + + + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + + + true to auto-complete the JSON when this writer is closed; otherwise false. The default is true. @@ -2740,34 +4694,34 @@ - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. - Get or set how time zones are handling when writing JSON text. + Gets or sets how time zones are handled when writing JSON text. - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. - Get or set how special floating point numbers, e.g. , + Gets or sets how special floating point numbers, e.g. , and , are written to JSON text. - Get or set how and values are formatting when writing JSON text. + Gets or sets how and values are formatted when writing JSON text. @@ -2777,17 +4731,19 @@ - Creates an instance of the JsonWriter class. + Initializes a new instance of the class. - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the destination and also flushes the destination. - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the destination is also closed. + If is set to true, the JSON is auto-completed. @@ -2823,13 +4779,13 @@ - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. - Writes the property name of a name/value pair on a JSON object. + Writes the property name of a name/value pair of a JSON object. The name of the property. A flag to indicate whether the text should be escaped when it is written as a JSON property name. @@ -2860,7 +4816,8 @@ The value to write. A value is only required for tokens that have an associated value, e.g. the property name for . - A null value can be passed to the method for token's that don't have a value, e.g. . + null can be passed to the method for tokens that don't have a value, e.g. . + @@ -3021,105 +4978,105 @@ - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. - Writes a value. + Writes a of value. - The value to write. + The of value to write. @@ -3142,32 +5099,260 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. - Writes out the given white space. + Writes the given white space. The string of white space characters. - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. - Sets the state of the JsonWriter, + Sets the state of the . - The JsonToken being written. + The being written. The value being written. + + + Specifies the type of JSON token. + + + + + This is returned by the if a read method has not been called. + + + + + An object start token. + + + + + An array start token. + + + + + A constructor start token. + + + + + An object property name. + + + + + A comment. + + + + + Raw JSON. + + + + + An integer. + + + + + A float. + + + + + A string. + + + + + A boolean. + + + + + A null token. + + + + + An undefined token. + + + + + An object end token. + + + + + An array end token. + + + + + A constructor end token. + + + + + A Date. + + + + + Byte data. + + + + + + Represents a reader that provides validation. + + + JSON Schema validation has been moved to its own package. See http://www.newtonsoft.com/jsonschema for more details. + + + + + + Sets an event handler for receiving schema validation errors. + + + + + Gets the text value of the current JSON token. + + + + + + Gets the depth of the current token in the JSON document. + + The depth of the current token in the JSON document. + + + + Gets the path of the current JSON token. + + + + + Gets the quotation mark character used to enclose the value of a string. + + + + + + Gets the type of the current JSON token. + + + + + + Gets the .NET type for the current JSON token. + + + + + + Initializes a new instance of the class that + validates the content returned from the given . + + The to read from while validating. + + + + Gets or sets the schema. + + The schema. + + + + Gets the used to construct this . + + The specified in the constructor. + + + + Changes the reader's state to . + If is set to true, the underlying is also closed. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a []. + + + A [] or null if the next JSON token is null. + + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying as a . + + A . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . This method will return null at the end of an array. + + + + Reads the next JSON token from the underlying as a of . + + A of . + + + + Reads the next JSON token from the underlying . + + + true if the next token was read successfully; false if there are no more tokens to read. + + - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. @@ -3194,1100 +5379,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. - - - - Specifies the member serialization options for the . - - - - - All public members are serialized by default. Members can be excluded using or . - This is the default member serialization mode. - - - - - Only members marked with or are serialized. - This member serialization mode can also be set by marking the class with . - - - - - All public and private fields are serialized. Members can be excluded using or . - This member serialization mode can also be set by marking the class with - and setting IgnoreSerializableAttribute on to false. - - - - - Specifies metadata property handling options for the . - - - - - Read metadata properties located at the start of a JSON object. - - - - - Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. - - - - - Do not try to read metadata properties. - - - - - Specifies missing member handling options for the . - - - - - Ignore a missing member and do not attempt to deserialize it. - - - - - Throw a when a missing member is encountered during deserialization. - - - - - Specifies null value handling options for the . - - - - - - - - - Include null values when serializing and deserializing objects. - - - - - Ignore null values when serializing and deserializing objects. - - - - - Specifies how object creation is handled by the . - - - - - Reuse existing objects, create new objects when needed. - - - - - Only reuse existing objects. - - - - - Always create new objects. - - - - - Specifies reference handling options for the . - Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement ISerializable. - - - - - - - - Do not preserve references when serializing types. - - - - - Preserve references when serializing into a JSON object structure. - - - - - Preserve references when serializing into a JSON array structure. - - - - - Preserve references when serializing. - - - - - Specifies reference loop handling options for the . - - - - - Throw a when a loop is encountered. - - - - - Ignore loop references and do not serialize. - - - - - Serialize loop references. - - - - - Indicating whether a property is required. - - - - - The property is not required. The default state. - - - - - The property must be defined in JSON but can be a null value. - - - - - The property must be defined in JSON and cannot be a null value. - - - - - The property is not required but it cannot be a null value. - - - - - Allows users to control class loading and mandate what class to load. - - - - - When overridden in a derived class, controls the binding of a serialized object to a type. - - Specifies the name of the serialized object. - Specifies the name of the serialized object - The type of the object the formatter creates a new instance of. - - - - When overridden in a derived class, controls the binding of a serialized object to a type. - - The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. - - - - Specifies how strings are escaped when writing JSON text. - - - - - Only control characters (e.g. newline) are escaped. - - - - - All non-ASCII and control characters (e.g. newline) are escaped. - - - - - HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. - - - - - Specifies what messages to output for the class. - - - - - Output no tracing and debugging messages. - - - - - Output error-handling messages. - - - - - Output warnings and error-handling messages. - - - - - Output informational messages, warnings, and error-handling messages. - - - - - Output all debugging and tracing messages. - - - - - Indicates the method that will be used during deserialization for locating and loading assemblies. - - - - - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. - - - - - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. - - - - - Specifies type name handling options for the . - - - should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom - when deserializing with a value other than TypeNameHandling.None. - - - - - Do not include the .NET type name when serializing types. - - - - - Include the .NET type name when serializing into a JSON object structure. - - - - - Include the .NET type name when serializing into a JSON array structure. - - - - - Always include the .NET type name when serializing. - - - - - Include the .NET type name when the type of the object being serialized is not the same as its declared type. - Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON - you must specify a root type object with - or . - - - - - Specifies the state of the . - - - - - An exception has been thrown, which has left the in an invalid state. - You may call the method to put the in the Closed state. - Any other method calls results in an being thrown. - - - - - The method has been called. - - - - - An object is being written. - - - - - A array is being written. - - - - - A constructor is being written. - - - - - A property is being written. - - - - - A write method has not been called. - - - - - Represents a BSON Oid (object id). - - - - - Gets or sets the value of the Oid. - - The value of the Oid. - - - - Initializes a new instance of the class. - - The Oid value. - - - - Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. - - - - - Gets or sets a value indicating whether binary data reading should compatible with incorrect Json.NET 3.5 written binary. - - - true if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, false. - - - - - Gets or sets a value indicating whether the root object will be read as a JSON array. - - - true if the root object will be read as a JSON array; otherwise, false. - - - - - Gets or sets the used when reading values from BSON. - - The used when reading values from BSON. - - - - Initializes a new instance of the class. - - The stream. - - - - Initializes a new instance of the class. - - The reader. - - - - Initializes a new instance of the class. - - The stream. - if set to true the root object will be read as a JSON array. - The used when reading values from BSON. - - - - Initializes a new instance of the class. - - The reader. - if set to true the root object will be read as a JSON array. - The used when reading values from BSON. - - - - Reads the next JSON token from the stream. - - - true if the next token was read successfully; false if there are no more tokens to read. - - - - - Changes the to Closed. - - - - - Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. - - - - - Gets or sets the used when writing values to BSON. - When set to no conversion will occur. - - The used when writing values to BSON. - - - - Initializes a new instance of the class. - - The stream. - - - - Initializes a new instance of the class. - - The writer. - - - - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. - - - - - Writes the end. - - The token. - - - - Writes out a comment /*...*/ containing the specified text. - - Text to place inside the comment. - - - - Writes the start of a constructor with the given name. - - The name of the constructor. - - - - Writes raw JSON. - - The raw JSON to write. - - - - Writes raw JSON where a value is expected and updates the writer's state. - - The raw JSON to write. - - - - Writes the beginning of a JSON array. - - - - - Writes the beginning of a JSON object. - - - - - Writes the property name of a name/value pair on a JSON object. - - The name of the property. - - - - Closes this stream and the underlying stream. - - - - - Writes a value. - An error will raised if the value cannot be written as a single JSON token. - - The value to write. - - - - Writes a null value. - - - - - Writes an undefined value. - - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a [] value. - - The [] value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a value. - - The value to write. - - - - Writes a [] value that represents a BSON object id. - - The Object ID value to write. - - - - Writes a BSON regex. - - The regex pattern. - The regex options. - - - - Converts a to and from JSON and BSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Create a custom object - - The object type to convert. - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Creates an object which will then be populated by the serializer. - - Type of the object. - The created object. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Gets a value indicating whether this can write JSON. - - - true if this can write JSON; otherwise, false. - - - - - Provides a base class for converting a to and from JSON. - - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts a F# discriminated union type to and from JSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts an ExpandoObject to and from JSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Gets a value indicating whether this can write JSON. - - - true if this can write JSON; otherwise, false. - - - - - Converts a to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). - - - - - Gets or sets the date time styles used when converting a date to and from JSON. - - The date time styles used when converting a date to and from JSON. - - - - Gets or sets the date time format used when converting a date to and from JSON. - - The date time format used when converting a date to and from JSON. - - - - Gets or sets the culture used when converting a date to and from JSON. - - The culture used when converting a date to and from JSON. - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Converts a to and from a JavaScript date constructor (e.g. new Date(52231943)). - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing property value of the JSON that is being converted. - The calling serializer. - The object value. - - - - Converts a to and from JSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts a to and from JSON and BSON. - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts an to and from its name string value. - - - - - Gets or sets a value indicating whether the written enum text should be camel case. - - true if the written enum text will be camel case; otherwise, false. - - - - Gets or sets a value indicating whether integer values are allowed when deserializing. - - true if integers are allowed when deserializing; otherwise, false. - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class. - - true if the written enum text will be camel case; otherwise, false. - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts a to and from a string (e.g. "1.2.3.4"). - - - - - Writes the JSON representation of the object. - - The to write to. - The value. - The calling serializer. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing property value of the JSON that is being converted. - The calling serializer. - The object value. - - - - Determines whether this instance can convert the specified object type. - - Type of the object. - - true if this instance can convert the specified object type; otherwise, false. - - - - - Converts XML to and from JSON. - - - - - Gets or sets the name of the root element to insert when deserializing to XML if the JSON structure has produces multiple root elements. - - The name of the deserialize root element. - - - - Gets or sets a flag to indicate whether to write the Json.NET array attribute. - This attribute helps preserve arrays when converting the written XML back to JSON. - - true if the array attibute is written to the XML; otherwise, false. - - - - Gets or sets a value indicating whether to write the root JSON object. - - true if the JSON root object is omitted; otherwise, false. - - - - Writes the JSON representation of the object. - - The to write to. - The calling serializer. - The value. - - - - Reads the JSON representation of the object. - - The to read from. - Type of the object. - The existing value of object being read. - The calling serializer. - The object value. - - - - Checks if the attributeName is a namespace attribute. - - Attribute name to test. - The attribute name prefix if it has one, otherwise an empty string. - true if attribute name is for a namespace attribute, otherwise false. - - - - Determines whether this instance can convert the specified value type. - - Type of the value. - - true if this instance can convert the specified value type; otherwise, false. - + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -4448,11 +5540,11 @@ Represents a collection of objects. - The type of token + The type of token. - Gets the with the specified key. + Gets the of with the specified key. @@ -4512,7 +5604,7 @@ A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . @@ -4531,7 +5623,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. @@ -4542,7 +5634,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -4550,7 +5642,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -4573,84 +5665,109 @@ - Determines the index of a specific item in the . + Determines the index of a specific item in the . - The object to locate in the . + The object to locate in the . The index of if found in the list; otherwise, -1. - Inserts an item to the at the specified index. + Inserts an item to the at the specified index. The zero-based index at which should be inserted. - The object to insert into the . + The object to insert into the . - is not a valid index in the . - The is read-only. + is not a valid index in the . + - Removes the item at the specified index. + Removes the item at the specified index. The zero-based index of the item to remove. - is not a valid index in the . - The is read-only. + is not a valid index in the . + Returns an enumerator that iterates through the collection. - A that can be used to iterate through the collection. + A of that can be used to iterate through the collection. - Adds an item to the . + Adds an item to the . - The object to add to the . - The is read-only. + The object to add to the . - Removes all items from the . + Removes all items from the . - The is read-only. - Determines whether the contains a specific value. + Determines whether the contains a specific value. - The object to locate in the . + The object to locate in the . - true if is found in the ; otherwise, false. + true if is found in the ; otherwise, false. - Copies to. + Copies the elements of the to an array, starting at a particular array index. The array. Index of the array. - Gets a value indicating whether the is read-only. + Gets a value indicating whether the is read-only. - true if the is read-only; otherwise, false. + true if the is read-only; otherwise, false. - Removes the first occurrence of a specific object from the . + Removes the first occurrence of a specific object from the . - The object to remove from the . + The object to remove from the . - true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . + true if was successfully removed from the ; otherwise, false. This method also returns false if is not found in the original . - The is read-only. + + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous load. The property contains the JSON that was read from the specified . @@ -4721,20 +5838,51 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Represents a token that can contain other tokens. @@ -4802,13 +5950,13 @@ Returns a collection of the descendant tokens for this token in document order. - An containing the descendant tokens of the . + An of containing the descendant tokens of the . Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. - An containing this token, and all the descendant tokens of the . + An of containing this token, and all the descendant tokens of the . @@ -4824,13 +5972,13 @@ - Creates an that can be used to add tokens to the . + Creates a that can be used to add tokens to the . - An that is ready to have content written to it. + A that is ready to have content written to it. - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. The content. @@ -4856,13 +6004,13 @@ Gets the count of child JSON tokens. - The count of child JSON tokens + The count of child JSON tokens. Represents a collection of objects. - The type of token + The type of token. @@ -4877,23 +6025,15 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. - - - Returns an enumerator that iterates through a collection. - - - An object that can be used to iterate through the collection. - - - Gets the with the specified key. + Gets the of with the specified key. @@ -4973,22 +6113,22 @@ - Gets an of this object's properties. + Gets an of of this object's properties. - An of this object's properties. + An of of this object's properties. Gets a the specified name. The property name. - A with the specified name or null. + A with the specified name or null. - Gets an of this object's property values. + Gets a of of this object's property values. - An of this object's property values. + A of of this object's property values. @@ -5004,7 +6144,7 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . @@ -5014,11 +6154,11 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . is not valid JSON. @@ -5043,7 +6183,7 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. is not valid JSON. @@ -5057,7 +6197,7 @@ Creates a from an object. The object that will be used to create . - A with the values of the specified object + A with the values of the specified object. @@ -5065,7 +6205,7 @@ The object that will be used to create . The that will be used to read the object. - A with the values of the specified object + A with the values of the specified object. @@ -5118,7 +6258,7 @@ - Tries the get value. + Tries to get the with the specified property name. Name of the property. The value. @@ -5126,7 +6266,7 @@ - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. A that can be used to iterate through the collection. @@ -5147,6 +6287,37 @@ The to bind this object. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous load. The + property returns a that contains the JSON that was read from the specified . + Represents a JSON property. @@ -5205,20 +6376,49 @@ - Loads an from a . + Loads a from a . A that will be read for the content of the . A that contains the JSON that was read from the specified . - Loads an from a . + Loads a from a . A that will be read for the content of the . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A that contains the JSON that was read from the specified . + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + + + + Asynchronously loads a from a . + + A that will be read for the content of the . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns a that contains the JSON that was read from the specified . + Represents a raw JSON string. @@ -5243,6 +6443,15 @@ The reader. An instance of with the content of the reader's current token. + + + Asynchronously creates an instance of with the content of the reader's current token. + + The reader. + The token to monitor for cancellation requests. The default value is . + A representing the asynchronous creation. The + property returns an instance of with the content of the reader's current token. + Specifies the settings used when loading JSON. @@ -5273,7 +6482,7 @@ - Gets or sets how how null value properties are merged. + Gets or sets how null value properties are merged. How null value properties are merged. @@ -5451,8 +6660,8 @@ Returns the JSON for this token using the given formatting and converters. - Indicates how the output is formatted. - A collection of which will be used when writing the token. + Indicates how the output should be formatted. + A collection of s which will be used when writing the token. The JSON for this token using the given formatting and converters. @@ -5471,49 +6680,49 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5562,56 +6771,56 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5625,14 +6834,14 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5688,7 +6897,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5702,7 +6911,7 @@ - Performs an explicit conversion from to . + Performs an explicit conversion from to of . The value. The result of the conversion. @@ -5737,7 +6946,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5751,49 +6960,49 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5821,7 +7030,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5835,14 +7044,14 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5856,28 +7065,28 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5940,7 +7149,7 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. @@ -5954,23 +7163,23 @@ - Performs an implicit conversion from to . + Performs an implicit conversion from of to . The value to create a from. The initialized with the specified value. - Creates an for this token. + Creates a for this token. - An that can be used to read this token and its descendants. + A that can be used to read this token and its descendants. Creates a from an object. The object that will be used to create . - A with the value of the specified object + A with the value of the specified object. @@ -5978,25 +7187,25 @@ The object that will be used to create . The that will be used when reading the object. - A with the value of the specified object + A with the value of the specified object. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the . + Creates an instance of the specified .NET type from the . The object type that the token will be deserialized to. The new object created from the JSON value. - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -6004,7 +7213,7 @@ - Creates the specified .NET type from the using the specified . + Creates an instance of the specified .NET type from the using the specified . The object type that the token will be deserialized to. The that will be used when creating the object. @@ -6014,9 +7223,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6027,9 +7236,9 @@ An positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6047,18 +7256,18 @@ A that contains JSON. The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. A populated from the string that contains JSON. Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . The used to load the JSON. - If this is null, default load settings will be used. + If this is null, default load settings will be used. - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6067,9 +7276,9 @@ Creates a from a . - An positioned at the token to read into this . + A positioned at the token to read into this . - An that contains the token and its descendant tokens + A that contains the token and its descendant tokens that were read from the reader. The runtime type of the token is determined by the token type of the first token encountered in the reader. @@ -6081,7 +7290,7 @@ A that contains a JPath expression. - A , or null. + A , or null. @@ -6100,7 +7309,7 @@ A that contains a JPath expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -6110,7 +7319,7 @@ A that contains a JPath expression. A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression. - An that contains the selected elements. + An of that contains the selected elements. @@ -6161,7 +7370,7 @@ Gets a collection of annotations of the specified type for this . The type of the annotations to retrieve. - An that contains the annotations for this . + An that contains the annotations for this . @@ -6182,6 +7391,81 @@ The of annotations to remove. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Writes this token to a asynchronously. + + A into which this method will write. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + An positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains + the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + + + + Asynchronously creates a from a . + + A positioned at the token to read into this . + The used to load the JSON. + If this is null, default load settings will be used. + The token to monitor for cancellation requests. The default value is . + + A that represents the asynchronous creation. The + property returns a that contains the token and its descendant tokens + that were read from the reader. The runtime type of the token is determined + by the token type of the first token encountered in the reader. + + Compares tokens to determine whether they are equal. @@ -6203,7 +7487,7 @@ The for which a hash code is to be returned. A hash code for the specified object. - The type of is a reference type and is null. + The type of is a reference type and is null. @@ -6223,7 +7507,7 @@ - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying . true if the next token was read successfully; false if there are no more tokens to read. @@ -6341,9 +7625,9 @@ - Gets the token being writen. + Gets the token being written. - The token being writen. + The token being written. @@ -6358,13 +7642,17 @@ - Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + Flushes whatever is in the buffer to the underlying . - Closes this stream and the underlying stream. + Closes this writer. + If is set to true, the JSON is auto-completed. + + Setting to true has no additional effect, since the underlying is a type that cannot be closed. + @@ -6397,7 +7685,7 @@ Writes a value. - An error will raised if the value cannot be written as a single JSON token. + An error will be raised if the value cannot be written as a single JSON token. The value to write. @@ -6419,7 +7707,7 @@ - Writes out a comment /*...*/ containing the specified text. + Writes a comment /*...*/ containing the specified text. Text to place inside the comment. @@ -6689,7 +7977,7 @@ Writes this token to a . A into which this method will write. - A collection of which will be used when writing the token. + A collection of s which will be used when writing the token. @@ -6708,9 +7996,6 @@ true if the specified is equal to the current ; otherwise, false. - - The parameter is null. - @@ -6782,9 +8067,18 @@ This instance is greater than . - is not the same type as this instance. + is not of the same type as this instance. + + + Writes this token to a asynchronously. + + A into which this method will write. + The token to monitor for cancellation requests. + A collection of which will be used when writing the token. + A that represents the asynchronous write operation. + Specifies how JSON arrays are merged together. @@ -6817,6 +8111,178 @@ The content's null value properties will be merged. + + + Specifies the member serialization options for the . + + + + + All public members are serialized by default. Members can be excluded using or . + This is the default member serialization mode. + + + + + Only members marked with or are serialized. + This member serialization mode can also be set by marking the class with . + + + + + All public and private fields are serialized. Members can be excluded using or . + This member serialization mode can also be set by marking the class with + and setting IgnoreSerializableAttribute on to false. + + + + + Specifies metadata property handling options for the . + + + + + Read metadata properties located at the start of a JSON object. + + + + + Read metadata properties located anywhere in a JSON object. Note that this setting will impact performance. + + + + + Do not try to read metadata properties. + + + + + Specifies missing member handling options for the . + + + + + Ignore a missing member and do not attempt to deserialize it. + + + + + Throw a when a missing member is encountered during deserialization. + + + + + Specifies null value handling options for the . + + + + + + + + + Include null values when serializing and deserializing objects. + + + + + Ignore null values when serializing and deserializing objects. + + + + + Specifies how object creation is handled by the . + + + + + Reuse existing objects, create new objects when needed. + + + + + Only reuse existing objects. + + + + + Always create new objects. + + + + + Specifies reference handling options for the . + Note that references cannot be preserved when a value is set via a non-default constructor such as types that implement . + + + + + + + + Do not preserve references when serializing types. + + + + + Preserve references when serializing into a JSON object structure. + + + + + Preserve references when serializing into a JSON array structure. + + + + + Preserve references when serializing. + + + + + Specifies reference loop handling options for the . + + + + + Throw a when a loop is encountered. + + + + + Ignore loop references and do not serialize. + + + + + Serialize loop references. + + + + + Indicating whether a property is required. + + + + + The property is not required. The default state. + + + + + The property must be defined in JSON but can be a null value. + + + + + The property must be defined in JSON and cannot be a null value. + + + + + The property is not required but it cannot be a null value. + + @@ -6910,7 +8376,7 @@ - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. @@ -6954,9 +8420,9 @@ - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. - A number that the value should be divisble by. + A number that the value should be divisible by. @@ -6972,15 +8438,15 @@ - Gets or sets a flag indicating whether the value can not equal the number defined by the "minimum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the minimum attribute (). - A flag indicating whether the value can not equal the number defined by the "minimum" attribute. + A flag indicating whether the value can not equal the number defined by the minimum attribute (). - Gets or sets a flag indicating whether the value can not equal the number defined by the "maximum" attribute. + Gets or sets a flag indicating whether the value can not equal the number defined by the maximum attribute (). - A flag indicating whether the value can not equal the number defined by the "maximum" attribute. + A flag indicating whether the value can not equal the number defined by the maximum attribute (). @@ -7069,7 +8535,7 @@ Gets or sets disallowed types. - The disallow types. + The disallowed types. @@ -7111,18 +8577,18 @@ - Load a from a string that contains schema JSON. + Load a from a string that contains JSON Schema. - A that contains JSON. - A populated from the string that contains JSON. + A that contains JSON Schema. + A populated from the string that contains JSON Schema. - Parses the specified json. + Load a from a string that contains JSON Schema using the specified . - The json. + A that contains JSON Schema. The resolver. - A populated from the string that contains JSON. + A populated from the string that contains JSON Schema. @@ -7191,7 +8657,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. The error message that explains the reason for the exception. - The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified. + The exception that is the cause of the current exception, or null if no inner exception is specified. @@ -7392,6 +8858,27 @@ + + + Allows users to control class loading and mandate what class to load. + + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + Specifies the name of the serialized object. + Specifies the name of the serialized object + The type of the object the formatter creates a new instance of. + + + + When overridden in a derived class, controls the binding of a serialized object to a type. + + The type of the object the formatter creates a new instance of. + Specifies the name of the serialized object. + Specifies the name of the serialized object. + A camel case naming strategy. @@ -7409,6 +8896,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -7431,9 +8933,46 @@ Initializes a new instance of the class. + + + The default naming strategy. Property names and dictionary keys are unchanged. + + + + + Resolves the specified property name. + + The property name to resolve. + The resolved property name. + + + + Get and set values for a using dynamic methods. + + + + + Initializes a new instance of the class. + + The member info. + + + + Sets the value. + + The target to set the value on. + The value to set on the target. + + + + Gets the value. + + The target to get the value from. + The value. + - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7472,7 +9011,7 @@ If set to true the will use a cached shared with other resolvers of the same type. Sharing the cache will significantly improve performance with multiple resolver instances because expensive reflection will only happen once. This setting can cause unexpected behavior if different instances of the resolver are suppose to produce different - results. When set to false it is highly recommended to reuse instances with the . + results. When set to false it is highly recommended to reuse instances with the . @@ -7598,6 +9137,13 @@ Name of the property. Resolved name of the property. + + + Resolves the name of the extension data. By default no changes are made to extension data names. + + Name of the extension data. + Resolved name of the extension data. + Resolves the key of the dictionary. By default is used to resolve dictionary keys. @@ -7612,18 +9158,6 @@ Name of the property. Name of the property. - - - The default naming strategy. Property names and dictionary keys are unchanged. - - - - - Resolves the specified property name. - - The property name to resolve. - The resolved property name. - The default serialization binder used when resolving and loading classes from type names. @@ -7649,8 +9183,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. The type of the object the formatter creates a new instance of. - Specifies the name of the serialized object. - Specifies the name of the serialized object. + Specifies the name of the serialized object. + Specifies the name of the serialized object. @@ -7711,31 +9245,6 @@ The current object. The error context. - - - Get and set values for a using dynamic methods. - - - - - Initializes a new instance of the class. - - The member info. - - - - Sets the value. - - The target to set the value on. - The value to set on the target. - - - - Gets the value. - - The target to get the value from. - The value. - Provides methods to get attributes. @@ -7745,7 +9254,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -7753,12 +9262,12 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. - Used by to resolves a for a given . + Used by to resolve a for a given . @@ -7783,11 +9292,11 @@ The serialization context. The reference to resolve. - The object that + The object that was resolved from the reference. - Gets the reference for the sepecified object. + Gets the reference for the specified object. The serialization context. The object to get a reference for. @@ -7840,8 +9349,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8068,7 +9577,7 @@ - Gets or sets a value indicating whether the default creator is non public. + Gets or sets a value indicating whether the default creator is non-public. true if the default object creator is non-public; otherwise, false. @@ -8180,7 +9689,7 @@ - Gets the constructor parameters required for any non-default constructor + Gets the constructor parameters required for any non-default constructor. @@ -8191,8 +9700,8 @@ Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. + This is set when a constructor is marked up using + . The override constructor. @@ -8224,6 +9733,12 @@ Gets or sets the extension data value type. + + + Gets or sets the extension data name resolver. + + The extension data name resolver. + Initializes a new instance of the class. @@ -8291,7 +9806,7 @@ Gets or sets the for the property. - If set this converter takes presidence over the contract converter for the property type. + If set this converter takes precedence over the contract converter for the property type. The converter. @@ -8377,9 +9892,9 @@ - Gets or sets a predicate used to determine whether the property should be serialize. + Gets or sets a predicate used to determine whether the property should be serialized. - A predicate used to determine whether the property should be serialize. + A predicate used to determine whether the property should be serialized. @@ -8421,13 +9936,13 @@ - Gets or sets the the type name handling used when serializing the property's collection items. + Gets or sets the type name handling used when serializing the property's collection items. The collection's items type name handling. - Gets or sets the the reference loop handling used when serializing the property's collection items. + Gets or sets the reference loop handling used when serializing the property's collection items. The collection's items reference loop handling. @@ -8458,7 +9973,7 @@ Gets the closest matching object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of and then a case insensitive match. Name of the property. @@ -8485,11 +10000,11 @@ - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the type described by the argument. - The JsonConverter type to create. + The type to create. Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used. + If null, the default constructor is used. @@ -8500,8 +10015,8 @@ Gets the that will be used to filter the trace messages passed to the writer. - For example a filter level of Info will exclude Verbose messages and include Info, - Warning and Error messages. + For example a filter level of will exclude messages and include , + and messages. The that will be used to filter the trace messages passed to the writer. @@ -8545,6 +10060,12 @@ Defaults to false. + + + A flag indicating whether extension data names should be processed. + Defaults to false. + + A flag indicating whether explicitly specified property names, @@ -8557,9 +10078,16 @@ Gets the serialized name for a given property name. The initial property name. - A flag indicating whether the property has had a name explicitly specfied. + A flag indicating whether the property has had a name explicitly specified. The serialized property name. + + + Gets the serialized name for a given extension data name. + + The initial extension data name. + The serialized extension data name. + Gets the serialized key for a given dictionary key. @@ -8600,7 +10128,7 @@ Returns a collection of all of the attributes, or an empty collection if there are no attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8608,7 +10136,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. The type of the attributes. - When true, look up the hierarchy chain for the inherited custom attribute. + When true, look up the hierarchy chain for the inherited custom attribute. A collection of s, or an empty collection. @@ -8653,6 +10181,21 @@ e.g. a property name customized with a . + + + Initializes a new instance of the class. + + + A flag indicating whether dictionary keys should be processed. + + + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a . + + + A flag indicating whether extension data names should be processed. + + Initializes a new instance of the class. @@ -8665,18 +10208,121 @@ The property name to resolve. The resolved property name. + + + Specifies how strings are escaped when writing JSON text. + + + + + Only control characters (e.g. newline) are escaped. + + + + + All non-ASCII and control characters (e.g. newline) are escaped. + + + + + HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. + + + + + Specifies what messages to output for the class. + + + + + Output no tracing and debugging messages. + + + + + Output error-handling messages. + + + + + Output warnings and error-handling messages. + + + + + Output informational messages, warnings, and error-handling messages. + + + + + Output all debugging and tracing messages. + + + + + Indicates the method that will be used during deserialization for locating and loading assemblies. + + + + + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method of the class is used to load the assembly. + + + + + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the class is used to load the assembly. + + + + + Specifies type name handling options for the . + + + should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom + when deserializing with a value other than . + + + + + Do not include the .NET type name when serializing types. + + + + + Include the .NET type name when serializing into a JSON object structure. + + + + + Include the .NET type name when serializing into a JSON array structure. + + + + + Always include the .NET type name when serializing. + + + + + Include the .NET type name when the type of the object being serialized is not the same as its declared type. + Note that this doesn't include the root serialized object by default. To include the root object's type name in JSON + you must specify a root type object with + or . + + - Determines whether the collection is null or empty. + Determines whether the collection is null or empty. The collection. - true if the collection is null or empty; otherwise, false. + true if the collection is null or empty; otherwise, false. - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic . The list to add to. The collection of elements to add. @@ -8732,17 +10378,17 @@ Mantissa Exponent - Adoption of native function NumberToDouble() from coreclr sources, + Adoption of native function NumberToDouble() from coreclr sources, see https://github.com/dotnet/coreclr/blob/master/src/classlibnative/bcltype/number.cpp#L451 - + Helper method for generating a MetaObject which calls a specific method on Dynamic that returns a result - + Helper method for generating a MetaObject which calls a specific method on Dynamic, but uses one of the arguments for @@ -8764,7 +10410,7 @@ - Gets a dictionary of the names and values of an Enum type. + Gets a dictionary of the names and values of an type. @@ -8795,19 +10441,19 @@ Checks if value of primitive type can be assigned to parameter of primitive type . - Source primitive type - Target primitive type - True if source type can be widened to target type, false otherwise + Source primitive type. + Target primitive type. + true if source type can be widened to target type, false otherwise. Checks if a set of values with given can be used to invoke a method with specified . - Method parameters - Argument types - Try to pack extra arguments into ParamArray - True if method can be called with given arguments, false otherwise + Method parameters. + Argument types. + Try to pack extra arguments into the last parameter when it is marked up with . + true if method can be called with given arguments, false otherwise. @@ -8817,11 +10463,11 @@ - Retunrs a best method overload for given argument . + Returns a best method overload for given argument . - List of method candidates - Argument types - Best method overload, or null if none matched + List of method candidates. + Argument types. + Best method overload, or null if none matched. @@ -8894,18 +10540,60 @@ - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike this class lets you reuse its internal buffer. - Determines whether the string is all white space. Empty string will return false. + Determines whether the string is all white space. Empty string will return false. The string to test whether it is all white space. true if the string is all white space; otherwise, false. + + + Specifies the state of the . + + + + + An exception has been thrown, which has left the in an invalid state. + You may call the method to put the in the Closed state. + Any other method calls result in an being thrown. + + + + + The method has been called. + + + + + An object is being written. + + + + + An array is being written. + + + + + A constructor is being written. + + + + + A property is being written. + + + + + A write method has not been called. + + Indicates the method that will be used during deserialization for locating and loading assemblies. @@ -8913,12 +10601,12 @@ - In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the LoadWithPartialName method is used to load the assembly. + In simple mode, the assembly used during deserialization need not match exactly the assembly used during serialization. Specifically, the version numbers need not match as the method is used to load the assembly. - In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The Load method of the Assembly class is used to load the assembly. + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The is used to load the assembly. diff --git a/packages/Newtonsoft.Json.9.0.2-beta1/tools/install.ps1 b/packages/Newtonsoft.Json.9.0.2-beta2/tools/install.ps1 similarity index 100% rename from packages/Newtonsoft.Json.9.0.2-beta1/tools/install.ps1 rename to packages/Newtonsoft.Json.9.0.2-beta2/tools/install.ps1