From 1aeba205ca41da0f9c31bb7c0e3c0d8534f69e61 Mon Sep 17 00:00:00 2001 From: zs <zhousong@weben-smart.com> Date: ćšć, 14 11æ 2024 17:20:40 +0800 Subject: [PATCH] fabu --- DataCapture_MA/bin/MA/Newtonsoft.Json.xml | 3531 ++++++++++++++++++++++++++++++++++++++++++++--------------- 1 files changed, 2,607 insertions(+), 924 deletions(-) diff --git a/DataCapture_MA/bin/MA/Newtonsoft.Json.xml b/DataCapture_MA/bin/MA/Newtonsoft.Json.xml index c719433..2ef7a77 100644 --- a/DataCapture_MA/bin/MA/Newtonsoft.Json.xml +++ b/DataCapture_MA/bin/MA/Newtonsoft.Json.xml @@ -23,12 +23,12 @@ </member> <member name="T:Newtonsoft.Json.Bson.BsonReader"> <summary> - 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. </summary> </member> <member name="P:Newtonsoft.Json.Bson.BsonReader.JsonNet35BinaryCompatibility"> <summary> - 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. </summary> <value> <c>true</c> if binary data reading will be compatible with incorrect Json.NET 3.5 written binary; otherwise, <c>false</c>. @@ -52,19 +52,19 @@ <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Bson.BsonReader"/> class. </summary> - <param name="stream">The stream.</param> + <param name="stream">The <see cref="T:System.IO.Stream"/> containing the BSON data to read.</param> </member> <member name="M:Newtonsoft.Json.Bson.BsonReader.#ctor(System.IO.BinaryReader)"> <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Bson.BsonReader"/> class. </summary> - <param name="reader">The reader.</param> + <param name="reader">The <see cref="T:System.IO.BinaryReader"/> containing the BSON data to read.</param> </member> <member name="M:Newtonsoft.Json.Bson.BsonReader.#ctor(System.IO.Stream,System.Boolean,System.DateTimeKind)"> <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Bson.BsonReader"/> class. </summary> - <param name="stream">The stream.</param> + <param name="stream">The <see cref="T:System.IO.Stream"/> containing the BSON data to read.</param> <param name="readRootValueAsArray">if set to <c>true</c> the root object will be read as a JSON array.</param> <param name="dateTimeKindHandling">The <see cref="T:System.DateTimeKind" /> used when reading <see cref="T:System.DateTime"/> values from BSON.</param> </member> @@ -72,13 +72,13 @@ <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Bson.BsonReader"/> class. </summary> - <param name="reader">The reader.</param> + <param name="reader">The <see cref="T:System.IO.BinaryReader"/> containing the BSON data to read.</param> <param name="readRootValueAsArray">if set to <c>true</c> the root object will be read as a JSON array.</param> <param name="dateTimeKindHandling">The <see cref="T:System.DateTimeKind" /> used when reading <see cref="T:System.DateTime"/> values from BSON.</param> </member> <member name="M:Newtonsoft.Json.Bson.BsonReader.Read"> <summary> - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying <see cref="T:System.IO.Stream"/>. </summary> <returns> <c>true</c> if the next token was read successfully; <c>false</c> if there are no more tokens to read. @@ -86,12 +86,13 @@ </member> <member name="M:Newtonsoft.Json.Bson.BsonReader.Close"> <summary> - Changes the <see cref="T:Newtonsoft.Json.JsonReader.State"/> to Closed. + Changes the reader's state to <see cref="F:Newtonsoft.Json.JsonReader.State.Closed"/>. + If <see cref="P:Newtonsoft.Json.JsonReader.CloseInput"/> is set to <c>true</c>, the underlying <see cref="T:System.IO.Stream"/> is also closed. </summary> </member> <member name="T:Newtonsoft.Json.Bson.BsonWriter"> <summary> - 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. </summary> </member> <member name="P:Newtonsoft.Json.Bson.BsonWriter.DateTimeKindHandling"> @@ -105,17 +106,17 @@ <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Bson.BsonWriter"/> class. </summary> - <param name="stream">The stream.</param> + <param name="stream">The <see cref="T:System.IO.Stream"/> to write to.</param> </member> <member name="M:Newtonsoft.Json.Bson.BsonWriter.#ctor(System.IO.BinaryWriter)"> <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Bson.BsonWriter"/> class. </summary> - <param name="writer">The writer.</param> + <param name="writer">The <see cref="T:System.IO.BinaryWriter"/> to write to.</param> </member> <member name="M:Newtonsoft.Json.Bson.BsonWriter.Flush"> <summary> - 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 <see cref="T:System.IO.Stream"/> and also flushes the underlying stream. </summary> </member> <member name="M:Newtonsoft.Json.Bson.BsonWriter.WriteEnd(Newtonsoft.Json.JsonToken)"> @@ -126,7 +127,7 @@ </member> <member name="M:Newtonsoft.Json.Bson.BsonWriter.WriteComment(System.String)"> <summary> - Writes out a comment <code>/*...*/</code> containing the specified text. + Writes a comment <c>/*...*/</c> containing the specified text. </summary> <param name="text">Text to place inside the comment.</param> </member> @@ -166,7 +167,9 @@ </member> <member name="M:Newtonsoft.Json.Bson.BsonWriter.Close"> <summary> - Closes this stream and the underlying stream. + Closes this writer. + If <see cref="P:Newtonsoft.Json.JsonWriter.CloseOutput"/> is set to <c>true</c>, the underlying <see cref="T:System.IO.Stream"/> is also closed. + If <see cref="P:Newtonsoft.Json.JsonWriter.AutoCompleteOnClose"/> is set to <c>true</c>, the JSON is auto-completed. </summary> </member> <member name="M:Newtonsoft.Json.Bson.BsonWriter.WriteValue(System.Object)"> @@ -326,7 +329,7 @@ </member> <member name="F:Newtonsoft.Json.ConstructorHandling.Default"> <summary> - 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. </summary> </member> <member name="F:Newtonsoft.Json.ConstructorHandling.AllowNonPublicDefaultConstructor"> @@ -400,7 +403,7 @@ </member> <member name="T:Newtonsoft.Json.Converters.CustomCreationConverter`1"> <summary> - Create a custom object + Creates a custom object. </summary> <typeparam name="T">The object type to convert.</typeparam> </member> @@ -558,7 +561,7 @@ </member> <member name="T:Newtonsoft.Json.Converters.EntityKeyMemberConverter"> <summary> - Converts an Entity Framework EntityKey to and from JSON. + Converts an Entity Framework <see cref="T:System.Data.EntityKeyMember"/> to and from JSON. </summary> </member> <member name="M:Newtonsoft.Json.Converters.EntityKeyMemberConverter.WriteJson(Newtonsoft.Json.JsonWriter,System.Object,Newtonsoft.Json.JsonSerializer)"> @@ -590,7 +593,7 @@ </member> <member name="T:Newtonsoft.Json.Converters.ExpandoObjectConverter"> <summary> - Converts an ExpandoObject to and from JSON. + Converts an <see cref="T:System.Dynamic.ExpandoObject"/> to and from JSON. </summary> </member> <member name="M:Newtonsoft.Json.Converters.ExpandoObjectConverter.WriteJson(Newtonsoft.Json.JsonWriter,System.Object,Newtonsoft.Json.JsonSerializer)"> @@ -630,7 +633,7 @@ </member> <member name="T:Newtonsoft.Json.Converters.IsoDateTimeConverter"> <summary> - Converts a <see cref="T:System.DateTime"/> to and from the ISO 8601 date format (e.g. 2008-04-12T12:53Z). + Converts a <see cref="T:System.DateTime"/> to and from the ISO 8601 date format (e.g. <c>"2008-04-12T12:53Z"</c>). </summary> </member> <member name="P:Newtonsoft.Json.Converters.IsoDateTimeConverter.DateTimeStyles"> @@ -671,7 +674,7 @@ </member> <member name="T:Newtonsoft.Json.Converters.JavaScriptDateTimeConverter"> <summary> - Converts a <see cref="T:System.DateTime"/> to and from a JavaScript date constructor (e.g. new Date(52231943)). + Converts a <see cref="T:System.DateTime"/> to and from a JavaScript <c>Date</c> constructor (e.g. <c>new Date(52231943)</c>). </summary> </member> <member name="M:Newtonsoft.Json.Converters.JavaScriptDateTimeConverter.WriteJson(Newtonsoft.Json.JsonWriter,System.Object,Newtonsoft.Json.JsonSerializer)"> @@ -764,14 +767,16 @@ <member name="P:Newtonsoft.Json.Converters.StringEnumConverter.CamelCaseText"> <summary> Gets or sets a value indicating whether the written enum text should be camel case. + The default value is <c>false</c>. </summary> <value><c>true</c> if the written enum text will be camel case; otherwise, <c>false</c>.</value> </member> <member name="P:Newtonsoft.Json.Converters.StringEnumConverter.AllowIntegerValues"> <summary> - Gets or sets a value indicating whether integer values are allowed. + Gets or sets a value indicating whether integer values are allowed when deserializing. + The default value is <c>true</c>. </summary> - <value><c>true</c> if integers are allowed; otherwise, <c>false</c>.</value> + <value><c>true</c> if integers are allowed when deserializing; otherwise, <c>false</c>.</value> </member> <member name="M:Newtonsoft.Json.Converters.StringEnumConverter.#ctor"> <summary> @@ -811,9 +816,32 @@ <c>true</c> if this instance can convert the specified object type; otherwise, <c>false</c>. </returns> </member> + <member name="T:Newtonsoft.Json.Converters.UnixDateTimeConverter"> + <summary> + Converts a <see cref="T:System.DateTime"/> to and from Unix epoch time + </summary> + </member> + <member name="M:Newtonsoft.Json.Converters.UnixDateTimeConverter.WriteJson(Newtonsoft.Json.JsonWriter,System.Object,Newtonsoft.Json.JsonSerializer)"> + <summary> + Writes the JSON representation of the object. + </summary> + <param name="writer">The <see cref="T:Newtonsoft.Json.JsonWriter"/> to write to.</param> + <param name="value">The value.</param> + <param name="serializer">The calling serializer.</param> + </member> + <member name="M:Newtonsoft.Json.Converters.UnixDateTimeConverter.ReadJson(Newtonsoft.Json.JsonReader,System.Type,System.Object,Newtonsoft.Json.JsonSerializer)"> + <summary> + Reads the JSON representation of the object. + </summary> + <param name="reader">The <see cref="T:Newtonsoft.Json.JsonReader"/> to read from.</param> + <param name="objectType">Type of the object.</param> + <param name="existingValue">The existing property value of the JSON that is being converted.</param> + <param name="serializer">The calling serializer.</param> + <returns>The object value.</returns> + </member> <member name="T:Newtonsoft.Json.Converters.VersionConverter"> <summary> - Converts a <see cref="T:System.Version"/> to and from a string (e.g. "1.2.3.4"). + Converts a <see cref="T:System.Version"/> to and from a string (e.g. <c>"1.2.3.4"</c>). </summary> </member> <member name="M:Newtonsoft.Json.Converters.VersionConverter.WriteJson(Newtonsoft.Json.JsonWriter,System.Object,Newtonsoft.Json.JsonSerializer)"> @@ -850,16 +878,16 @@ </member> <member name="P:Newtonsoft.Json.Converters.XmlNodeConverter.DeserializeRootElementName"> <summary> - 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. </summary> - <value>The name of the deserialize root element.</value> + <value>The name of the deserialized root element.</value> </member> <member name="P:Newtonsoft.Json.Converters.XmlNodeConverter.WriteArrayAttribute"> <summary> 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. </summary> - <value><c>true</c> if the array attibute is written to the XML; otherwise, <c>false</c>.</value> + <value><c>true</c> if the array attribute is written to the XML; otherwise, <c>false</c>.</value> </member> <member name="P:Newtonsoft.Json.Converters.XmlNodeConverter.OmitRootObject"> <summary> @@ -887,7 +915,7 @@ </member> <member name="M:Newtonsoft.Json.Converters.XmlNodeConverter.IsNamespaceAttribute(System.String,System.String@)"> <summary> - Checks if the attributeName is a namespace attribute. + Checks if the <paramref name="attributeName"/> is a namespace attribute. </summary> <param name="attributeName">Attribute name to test.</param> <param name="prefix">The attribute name prefix if it has one, otherwise an empty string.</param> @@ -902,21 +930,6 @@ <c>true</c> if this instance can convert the specified value type; otherwise, <c>false</c>. </returns> </member> - <member name="T:Newtonsoft.Json.FloatParseHandling"> - <summary> - Specifies how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. - </summary> - </member> - <member name="F:Newtonsoft.Json.FloatParseHandling.Double"> - <summary> - Floating point numbers are parsed to <see cref="F:Newtonsoft.Json.FloatParseHandling.Double"/>. - </summary> - </member> - <member name="F:Newtonsoft.Json.FloatParseHandling.Decimal"> - <summary> - Floating point numbers are parsed to <see cref="F:Newtonsoft.Json.FloatParseHandling.Decimal"/>. - </summary> - </member> <member name="T:Newtonsoft.Json.DateFormatHandling"> <summary> Specifies how dates are formatted when writing JSON text. @@ -924,17 +937,17 @@ </member> <member name="F:Newtonsoft.Json.DateFormatHandling.IsoDateFormat"> <summary> - Dates are written in the ISO 8601 format, e.g. "2012-03-21T05:40Z". + Dates are written in the ISO 8601 format, e.g. <c>"2012-03-21T05:40Z"</c>. </summary> </member> <member name="F:Newtonsoft.Json.DateFormatHandling.MicrosoftDateFormat"> <summary> - Dates are written in the Microsoft JSON format, e.g. "\/Date(1198908717056)\/". + Dates are written in the Microsoft JSON format, e.g. <c>"\/Date(1198908717056)\/"</c>. </summary> </member> <member name="T:Newtonsoft.Json.DateParseHandling"> <summary> - 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. <c>"\/Date(1198908717056)\/"</c> and <c>"2012-03-21T05:40Z"</c>, are parsed when reading JSON text. </summary> </member> <member name="F:Newtonsoft.Json.DateParseHandling.None"> @@ -944,12 +957,12 @@ </member> <member name="F:Newtonsoft.Json.DateParseHandling.DateTime"> <summary> - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to <see cref="F:Newtonsoft.Json.DateParseHandling.DateTime"/>. + Date formatted strings, e.g. <c>"\/Date(1198908717056)\/"</c> and <c>"2012-03-21T05:40Z"</c>, are parsed to <see cref="F:Newtonsoft.Json.DateParseHandling.DateTime"/>. </summary> </member> <member name="F:Newtonsoft.Json.DateParseHandling.DateTimeOffset"> <summary> - Date formatted strings, e.g. "\/Date(1198908717056)\/" and "2012-03-21T05:40Z", are parsed to <see cref="F:Newtonsoft.Json.DateParseHandling.DateTimeOffset"/>. + Date formatted strings, e.g. <c>"\/Date(1198908717056)\/"</c> and <c>"2012-03-21T05:40Z"</c>, are parsed to <see cref="F:Newtonsoft.Json.DateParseHandling.DateTimeOffset"/>. </summary> </member> <member name="T:Newtonsoft.Json.DateTimeZoneHandling"> @@ -996,7 +1009,7 @@ <member name="F:Newtonsoft.Json.DefaultValueHandling.Ignore"> <summary> 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. <c>null</c> for objects and nullable types; <c>0</c> for integers, decimals and floating point numbers; and <c>false</c> for booleans). The default value ignored can be changed by placing the <see cref="T:System.ComponentModel.DefaultValueAttribute"/> on the property. @@ -1010,7 +1023,7 @@ <member name="F:Newtonsoft.Json.DefaultValueHandling.IgnoreAndPopulate"> <summary> 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. </summary> </member> <member name="T:Newtonsoft.Json.FloatFormatHandling"> @@ -1021,18 +1034,33 @@ </member> <member name="F:Newtonsoft.Json.FloatFormatHandling.String"> <summary> - 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. <c>"NaN"</c>, <c>"Infinity"</c>, <c>"-Infinity"</c>. </summary> </member> <member name="F:Newtonsoft.Json.FloatFormatHandling.Symbol"> <summary> - 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. <c>NaN</c>, <c>Infinity</c>, <c>-Infinity</c>. Note that this will produce non-valid JSON. </summary> </member> <member name="F:Newtonsoft.Json.FloatFormatHandling.DefaultValue"> <summary> - Write special floating point values as the property's default value in JSON, e.g. 0.0 for a <see cref="T:System.Double"/> property, null for a <see cref="T:System.Nullable`1"/> property. + Write special floating point values as the property's default value in JSON, e.g. 0.0 for a <see cref="T:System.Double"/> property, <c>null</c> for a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> property. + </summary> + </member> + <member name="T:Newtonsoft.Json.FloatParseHandling"> + <summary> + Specifies how floating point numbers, e.g. 1.0 and 9.9, are parsed when reading JSON text. + </summary> + </member> + <member name="F:Newtonsoft.Json.FloatParseHandling.Double"> + <summary> + Floating point numbers are parsed to <see cref="F:Newtonsoft.Json.FloatParseHandling.Double"/>. + </summary> + </member> + <member name="F:Newtonsoft.Json.FloatParseHandling.Decimal"> + <summary> + Floating point numbers are parsed to <see cref="F:Newtonsoft.Json.FloatParseHandling.Decimal"/>. </summary> </member> <member name="T:Newtonsoft.Json.Formatting"> @@ -1058,7 +1086,7 @@ </member> <member name="M:Newtonsoft.Json.IArrayPool`1.Rent(System.Int32)"> <summary> - 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. </summary> <param name="minimumLength">The minimum required length of the array. The returned array may be longer.</param> <returns>The rented array from the pool. This array must be returned when it is no longer needed.</returns> @@ -1079,20 +1107,20 @@ Gets a value indicating whether the class can return line information. </summary> <returns> - <c>true</c> if LineNumber and LinePosition can be provided; otherwise, <c>false</c>. + <c>true</c> if <see cref="P:Newtonsoft.Json.IJsonLineInfo.LineNumber"/> and <see cref="P:Newtonsoft.Json.IJsonLineInfo.LinePosition"/> can be provided; otherwise, <c>false</c>. </returns> </member> <member name="P:Newtonsoft.Json.IJsonLineInfo.LineNumber"> <summary> Gets the current line number. </summary> - <value>The current line number or 0 if no line information is available (for example, HasLineInfo returns false).</value> + <value>The current line number or 0 if no line information is available (for example, when <see cref="M:Newtonsoft.Json.IJsonLineInfo.HasLineInfo"/> returns <c>false</c>).</value> </member> <member name="P:Newtonsoft.Json.IJsonLineInfo.LinePosition"> <summary> Gets the current line position. </summary> - <value>The current line position or 0 if no line information is available (for example, HasLineInfo returns false).</value> + <value>The current line position or 0 if no line information is available (for example, when <see cref="M:Newtonsoft.Json.IJsonLineInfo.HasLineInfo"/> returns <c>false</c>).</value> </member> <member name="T:Newtonsoft.Json.JsonArrayAttribute"> <summary> @@ -1112,7 +1140,7 @@ </member> <member name="M:Newtonsoft.Json.JsonArrayAttribute.#ctor(System.Boolean)"> <summary> - Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonObjectAttribute"/> class with a flag indicating whether the array can contain null items + Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonObjectAttribute"/> class with a flag indicating whether the array can contain null items. </summary> <param name="allowNullItems">A flag indicating whether the array can contain null items.</param> </member> @@ -1158,13 +1186,15 @@ </member> <member name="P:Newtonsoft.Json.JsonContainerAttribute.ItemConverterParameters"> <summary> - The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/> described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.JsonConverter"/> that exactly matches the number, + The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/> described by <see cref="P:Newtonsoft.Json.JsonContainerAttribute.ItemConverterType"/>. + If <c>null</c>, the default constructor is used. + When non-<c>null</c>, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.JsonConverter"/> that exactly matches the number, order, and type of these parameters. </summary> <example> + <code> [JsonContainer(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + </code> </example> </member> <member name="P:Newtonsoft.Json.JsonContainerAttribute.NamingStrategyType"> @@ -1175,13 +1205,15 @@ </member> <member name="P:Newtonsoft.Json.JsonContainerAttribute.NamingStrategyParameters"> <summary> - The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> that exactly matches the number, + The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> described by <see cref="P:Newtonsoft.Json.JsonContainerAttribute.NamingStrategyType"/>. + If <c>null</c>, the default constructor is used. + When non-<c>null</c>, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> that exactly matches the number, order, and type of these parameters. </summary> <example> + <code> [JsonContainer(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + </code> </example> </member> <member name="P:Newtonsoft.Json.JsonContainerAttribute.IsReference"> @@ -1225,7 +1257,7 @@ </member> <member name="T:Newtonsoft.Json.JsonConvert"> <summary> - Provides methods for converting between common language runtime types and JSON types. + Provides methods for converting between .NET types and JSON types. </summary> <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\SerializationTests.cs" region="SerializeObject" title="Serializing and Deserializing JSON with JsonConvert" /> @@ -1242,22 +1274,22 @@ </member> <member name="F:Newtonsoft.Json.JsonConvert.True"> <summary> - Represents JavaScript's boolean value true as a string. This field is read-only. + Represents JavaScript's boolean value <c>true</c> as a string. This field is read-only. </summary> </member> <member name="F:Newtonsoft.Json.JsonConvert.False"> <summary> - Represents JavaScript's boolean value false as a string. This field is read-only. + Represents JavaScript's boolean value <c>false</c> as a string. This field is read-only. </summary> </member> <member name="F:Newtonsoft.Json.JsonConvert.Null"> <summary> - Represents JavaScript's null as a string. This field is read-only. + Represents JavaScript's <c>null</c> as a string. This field is read-only. </summary> </member> <member name="F:Newtonsoft.Json.JsonConvert.Undefined"> <summary> - Represents JavaScript's undefined as a string. This field is read-only. + Represents JavaScript's <c>undefined</c> as a string. This field is read-only. </summary> </member> <member name="F:Newtonsoft.Json.JsonConvert.PositiveInfinity"> @@ -1272,7 +1304,7 @@ </member> <member name="F:Newtonsoft.Json.JsonConvert.NaN"> <summary> - Represents JavaScript's NaN as a string. This field is read-only. + Represents JavaScript's <c>NaN</c> as a string. This field is read-only. </summary> </member> <member name="M:Newtonsoft.Json.JsonConvert.ToString(System.DateTime)"> @@ -1468,7 +1500,7 @@ Serializes the specified object to a JSON string using formatting. </summary> <param name="value">The object to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> + <param name="formatting">Indicates how the output should be formatted.</param> <returns> A JSON string representation of the object. </returns> @@ -1478,7 +1510,7 @@ Serializes the specified object to a JSON string using a collection of <see cref="T:Newtonsoft.Json.JsonConverter"/>. </summary> <param name="value">The object to serialize.</param> - <param name="converters">A collection converters used while serializing.</param> + <param name="converters">A collection of converters used while serializing.</param> <returns>A JSON string representation of the object.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeObject(System.Object,Newtonsoft.Json.Formatting,Newtonsoft.Json.JsonConverter[])"> @@ -1486,8 +1518,8 @@ Serializes the specified object to a JSON string using formatting and a collection of <see cref="T:Newtonsoft.Json.JsonConverter"/>. </summary> <param name="value">The object to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> - <param name="converters">A collection converters used while serializing.</param> + <param name="formatting">Indicates how the output should be formatted.</param> + <param name="converters">A collection of converters used while serializing.</param> <returns>A JSON string representation of the object.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeObject(System.Object,Newtonsoft.Json.JsonSerializerSettings)"> @@ -1496,7 +1528,7 @@ </summary> <param name="value">The object to serialize.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to serialize the object. - If this is null, default serialization settings will be used.</param> + If this is <c>null</c>, default serialization settings will be used.</param> <returns> A JSON string representation of the object. </returns> @@ -1507,11 +1539,11 @@ </summary> <param name="value">The object to serialize.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to serialize the object. - If this is null, default serialization settings will be used.</param> + If this is <c>null</c>, default serialization settings will be used.</param> <param name="type"> The type of the value being serialized. - This parameter is used when <see cref="T:Newtonsoft.Json.TypeNameHandling"/> 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 <see cref="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"/> is <see cref="F:Newtonsoft.Json.TypeNameHandling.Auto"/> to write out the type name if the type of the value does not match. + Specifying the type is optional. </param> <returns> A JSON string representation of the object. @@ -1522,9 +1554,9 @@ Serializes the specified object to a JSON string using formatting and <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/>. </summary> <param name="value">The object to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> + <param name="formatting">Indicates how the output should be formatted.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to serialize the object. - If this is null, default serialization settings will be used.</param> + If this is <c>null</c>, default serialization settings will be used.</param> <returns> A JSON string representation of the object. </returns> @@ -1534,50 +1566,16 @@ Serializes the specified object to a JSON string using a type, formatting and <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/>. </summary> <param name="value">The object to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> + <param name="formatting">Indicates how the output should be formatted.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to serialize the object. - If this is null, default serialization settings will be used.</param> + If this is <c>null</c>, default serialization settings will be used.</param> <param name="type"> The type of the value being serialized. - This parameter is used when <see cref="T:Newtonsoft.Json.TypeNameHandling"/> 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 <see cref="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"/> is <see cref="F:Newtonsoft.Json.TypeNameHandling.Auto"/> to write out the type name if the type of the value does not match. + Specifying the type is optional. </param> <returns> A JSON string representation of the object. - </returns> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.SerializeObjectAsync(System.Object)"> - <summary> - Asynchronously serializes the specified object to a JSON string. - Serialization will happen on a new thread. - </summary> - <param name="value">The object to serialize.</param> - <returns> - A task that represents the asynchronous serialize operation. The value of the <c>TResult</c> parameter contains a JSON string representation of the object. - </returns> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.SerializeObjectAsync(System.Object,Newtonsoft.Json.Formatting)"> - <summary> - Asynchronously serializes the specified object to a JSON string using formatting. - Serialization will happen on a new thread. - </summary> - <param name="value">The object to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> - <returns> - A task that represents the asynchronous serialize operation. The value of the <c>TResult</c> parameter contains a JSON string representation of the object. - </returns> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.SerializeObjectAsync(System.Object,Newtonsoft.Json.Formatting,Newtonsoft.Json.JsonSerializerSettings)"> - <summary> - Asynchronously serializes the specified object to a JSON string using formatting and a collection of <see cref="T:Newtonsoft.Json.JsonConverter"/>. - Serialization will happen on a new thread. - </summary> - <param name="value">The object to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> - <param name="settings">The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to serialize the object. - If this is null, default serialization settings will be used.</param> - <returns> - A task that represents the asynchronous serialize operation. The value of the <c>TResult</c> parameter contains a JSON string representation of the object. </returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.DeserializeObject(System.String)"> @@ -1594,7 +1592,7 @@ <param name="value">The JSON to deserialize.</param> <param name="settings"> The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. + If this is <c>null</c>, default serialization settings will be used. </param> <returns>The deserialized object from the JSON string.</returns> </member> @@ -1620,7 +1618,7 @@ </summary> <typeparam name="T"> 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. </typeparam> <param name="value">The JSON to deserialize.</param> @@ -1633,14 +1631,14 @@ </summary> <typeparam name="T"> 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. </typeparam> <param name="value">The JSON to deserialize.</param> <param name="anonymousTypeObject">The anonymous type object.</param> <param name="settings"> The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. + If this is <c>null</c>, default serialization settings will be used. </param> <returns>The deserialized anonymous type from the JSON string.</returns> </member> @@ -1661,7 +1659,7 @@ <param name="value">The object to deserialize.</param> <param name="settings"> The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. + If this is <c>null</c>, default serialization settings will be used. </param> <returns>The deserialized object from the JSON string.</returns> </member> @@ -1682,60 +1680,9 @@ <param name="type">The type of the object to deserialize to.</param> <param name="settings"> The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. + If this is <c>null</c>, default serialization settings will be used. </param> <returns>The deserialized object from the JSON string.</returns> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.DeserializeObjectAsync``1(System.String)"> - <summary> - Asynchronously deserializes the JSON to the specified .NET type. - Deserialization will happen on a new thread. - </summary> - <typeparam name="T">The type of the object to deserialize to.</typeparam> - <param name="value">The JSON to deserialize.</param> - <returns> - A task that represents the asynchronous deserialize operation. The value of the <c>TResult</c> parameter contains the deserialized object from the JSON string. - </returns> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.DeserializeObjectAsync``1(System.String,Newtonsoft.Json.JsonSerializerSettings)"> - <summary> - Asynchronously deserializes the JSON to the specified .NET type using <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/>. - Deserialization will happen on a new thread. - </summary> - <typeparam name="T">The type of the object to deserialize to.</typeparam> - <param name="value">The JSON to deserialize.</param> - <param name="settings"> - The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. - </param> - <returns> - A task that represents the asynchronous deserialize operation. The value of the <c>TResult</c> parameter contains the deserialized object from the JSON string. - </returns> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.DeserializeObjectAsync(System.String)"> - <summary> - Asynchronously deserializes the JSON to the specified .NET type. - Deserialization will happen on a new thread. - </summary> - <param name="value">The JSON to deserialize.</param> - <returns> - A task that represents the asynchronous deserialize operation. The value of the <c>TResult</c> parameter contains the deserialized object from the JSON string. - </returns> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.DeserializeObjectAsync(System.String,System.Type,Newtonsoft.Json.JsonSerializerSettings)"> - <summary> - Asynchronously deserializes the JSON to the specified .NET type using <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/>. - Deserialization will happen on a new thread. - </summary> - <param name="value">The JSON to deserialize.</param> - <param name="type">The type of the object to deserialize to.</param> - <param name="settings"> - The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. - </param> - <returns> - A task that represents the asynchronous deserialize operation. The value of the <c>TResult</c> parameter contains the deserialized object from the JSON string. - </returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.PopulateObject(System.String,System.Object)"> <summary> @@ -1752,66 +1699,52 @@ <param name="target">The target object to populate values onto.</param> <param name="settings"> The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. + If this is <c>null</c>, default serialization settings will be used. </param> - </member> - <member name="M:Newtonsoft.Json.JsonConvert.PopulateObjectAsync(System.String,System.Object,Newtonsoft.Json.JsonSerializerSettings)"> - <summary> - Asynchronously populates the object with values from the JSON string using <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/>. - </summary> - <param name="value">The JSON to populate values from.</param> - <param name="target">The target object to populate values onto.</param> - <param name="settings"> - The <see cref="T:Newtonsoft.Json.JsonSerializerSettings"/> used to deserialize the object. - If this is null, default serialization settings will be used. - </param> - <returns> - A task that represents the asynchronous populate operation. - </returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeXmlNode(System.Xml.XmlNode)"> <summary> - Serializes the XML node to a JSON string. + Serializes the <see cref="T:System.Xml.XmlNode"/> to a JSON string. </summary> <param name="node">The node to serialize.</param> - <returns>A JSON string of the XmlNode.</returns> + <returns>A JSON string of the <see cref="T:System.Xml.XmlNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeXmlNode(System.Xml.XmlNode,Newtonsoft.Json.Formatting)"> <summary> - Serializes the XML node to a JSON string using formatting. + Serializes the <see cref="T:System.Xml.XmlNode"/> to a JSON string using formatting. </summary> <param name="node">The node to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> - <returns>A JSON string of the XmlNode.</returns> + <param name="formatting">Indicates how the output should be formatted.</param> + <returns>A JSON string of the <see cref="T:System.Xml.XmlNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeXmlNode(System.Xml.XmlNode,Newtonsoft.Json.Formatting,System.Boolean)"> <summary> - Serializes the XML node to a JSON string using formatting and omits the root object if <paramref name="omitRootObject"/> is <c>true</c>. + Serializes the <see cref="T:System.Xml.XmlNode"/> to a JSON string using formatting and omits the root object if <paramref name="omitRootObject"/> is <c>true</c>. </summary> <param name="node">The node to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> + <param name="formatting">Indicates how the output should be formatted.</param> <param name="omitRootObject">Omits writing the root object.</param> - <returns>A JSON string of the XmlNode.</returns> + <returns>A JSON string of the <see cref="T:System.Xml.XmlNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.DeserializeXmlNode(System.String)"> <summary> - Deserializes the XmlNode from a JSON string. + Deserializes the <see cref="T:System.Xml.XmlNode"/> from a JSON string. </summary> <param name="value">The JSON string.</param> - <returns>The deserialized XmlNode</returns> + <returns>The deserialized <see cref="T:System.Xml.XmlNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.DeserializeXmlNode(System.String,System.String)"> <summary> - Deserializes the XmlNode from a JSON string nested in a root elment specified by <paramref name="deserializeRootElementName"/>. + Deserializes the <see cref="T:System.Xml.XmlNode"/> from a JSON string nested in a root element specified by <paramref name="deserializeRootElementName"/>. </summary> <param name="value">The JSON string.</param> <param name="deserializeRootElementName">The name of the root element to append when deserializing.</param> - <returns>The deserialized XmlNode</returns> + <returns>The deserialized <see cref="T:System.Xml.XmlNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.DeserializeXmlNode(System.String,System.String,System.Boolean)"> <summary> - Deserializes the XmlNode from a JSON string nested in a root elment specified by <paramref name="deserializeRootElementName"/> - and writes a .NET array attribute for collections. + Deserializes the <see cref="T:System.Xml.XmlNode"/> from a JSON string nested in a root element specified by <paramref name="deserializeRootElementName"/> + and writes a Json.NET array attribute for collections. </summary> <param name="value">The JSON string.</param> <param name="deserializeRootElementName">The name of the root element to append when deserializing.</param> @@ -1819,51 +1752,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. </param> - <returns>The deserialized XmlNode</returns> + <returns>The deserialized <see cref="T:System.Xml.XmlNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeXNode(System.Xml.Linq.XObject)"> <summary> Serializes the <see cref="T:System.Xml.Linq.XNode"/> to a JSON string. </summary> <param name="node">The node to convert to JSON.</param> - <returns>A JSON string of the XNode.</returns> + <returns>A JSON string of the <see cref="T:System.Xml.Linq.XNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeXNode(System.Xml.Linq.XObject,Newtonsoft.Json.Formatting)"> <summary> Serializes the <see cref="T:System.Xml.Linq.XNode"/> to a JSON string using formatting. </summary> <param name="node">The node to convert to JSON.</param> - <param name="formatting">Indicates how the output is formatted.</param> - <returns>A JSON string of the XNode.</returns> + <param name="formatting">Indicates how the output should be formatted.</param> + <returns>A JSON string of the <see cref="T:System.Xml.Linq.XNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.SerializeXNode(System.Xml.Linq.XObject,Newtonsoft.Json.Formatting,System.Boolean)"> <summary> Serializes the <see cref="T:System.Xml.Linq.XNode"/> to a JSON string using formatting and omits the root object if <paramref name="omitRootObject"/> is <c>true</c>. </summary> <param name="node">The node to serialize.</param> - <param name="formatting">Indicates how the output is formatted.</param> + <param name="formatting">Indicates how the output should be formatted.</param> <param name="omitRootObject">Omits writing the root object.</param> - <returns>A JSON string of the XNode.</returns> + <returns>A JSON string of the <see cref="T:System.Xml.Linq.XNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.DeserializeXNode(System.String)"> <summary> Deserializes the <see cref="T:System.Xml.Linq.XNode"/> from a JSON string. </summary> <param name="value">The JSON string.</param> - <returns>The deserialized XNode</returns> + <returns>The deserialized <see cref="T:System.Xml.Linq.XNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.DeserializeXNode(System.String,System.String)"> <summary> - Deserializes the <see cref="T:System.Xml.Linq.XNode"/> from a JSON string nested in a root elment specified by <paramref name="deserializeRootElementName"/>. + Deserializes the <see cref="T:System.Xml.Linq.XNode"/> from a JSON string nested in a root element specified by <paramref name="deserializeRootElementName"/>. </summary> <param name="value">The JSON string.</param> <param name="deserializeRootElementName">The name of the root element to append when deserializing.</param> - <returns>The deserialized XNode</returns> + <returns>The deserialized <see cref="T:System.Xml.Linq.XNode"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonConvert.DeserializeXNode(System.String,System.String,System.Boolean)"> <summary> - Deserializes the <see cref="T:System.Xml.Linq.XNode"/> from a JSON string nested in a root elment specified by <paramref name="deserializeRootElementName"/> - and writes a .NET array attribute for collections. + Deserializes the <see cref="T:System.Xml.Linq.XNode"/> from a JSON string nested in a root element specified by <paramref name="deserializeRootElementName"/> + and writes a Json.NET array attribute for collections. </summary> <param name="value">The JSON string.</param> <param name="deserializeRootElementName">The name of the root element to append when deserializing.</param> @@ -1871,7 +1804,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. </param> - <returns>The deserialized XNode</returns> + <returns>The deserialized <see cref="T:System.Xml.Linq.XNode"/>.</returns> </member> <member name="T:Newtonsoft.Json.JsonConverter"> <summary> @@ -1905,17 +1838,6 @@ <c>true</c> if this instance can convert the specified object type; otherwise, <c>false</c>. </returns> </member> - <member name="M:Newtonsoft.Json.JsonConverter.GetSchema"> - <summary> - <para> - Gets the <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> of the JSON produced by the JsonConverter. - </para> - <note type="caution"> - JSON Schema validation has been moved to its own package. See <see href="http://www.newtonsoft.com/jsonschema">http://www.newtonsoft.com/jsonschema</see> for more details. - </note> - </summary> - <returns>The <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> of the JSON produced by the JsonConverter.</returns> - </member> <member name="P:Newtonsoft.Json.JsonConverter.CanRead"> <summary> Gets a value indicating whether this <see cref="T:Newtonsoft.Json.JsonConverter"/> can read JSON. @@ -1927,6 +1849,58 @@ Gets a value indicating whether this <see cref="T:Newtonsoft.Json.JsonConverter"/> can write JSON. </summary> <value><c>true</c> if this <see cref="T:Newtonsoft.Json.JsonConverter"/> can write JSON; otherwise, <c>false</c>.</value> + </member> + <member name="T:Newtonsoft.Json.JsonConverter`1"> + <summary> + Converts an object to and from JSON. + </summary> + <typeparam name="T">The object type to convert.</typeparam> + </member> + <member name="M:Newtonsoft.Json.JsonConverter`1.WriteJson(Newtonsoft.Json.JsonWriter,System.Object,Newtonsoft.Json.JsonSerializer)"> + <summary> + Writes the JSON representation of the object. + </summary> + <param name="writer">The <see cref="T:Newtonsoft.Json.JsonWriter"/> to write to.</param> + <param name="value">The value.</param> + <param name="serializer">The calling serializer.</param> + </member> + <member name="M:Newtonsoft.Json.JsonConverter`1.WriteJson(Newtonsoft.Json.JsonWriter,`0,Newtonsoft.Json.JsonSerializer)"> + <summary> + Writes the JSON representation of the object. + </summary> + <param name="writer">The <see cref="T:Newtonsoft.Json.JsonWriter"/> to write to.</param> + <param name="value">The value.</param> + <param name="serializer">The calling serializer.</param> + </member> + <member name="M:Newtonsoft.Json.JsonConverter`1.ReadJson(Newtonsoft.Json.JsonReader,System.Type,System.Object,Newtonsoft.Json.JsonSerializer)"> + <summary> + Reads the JSON representation of the object. + </summary> + <param name="reader">The <see cref="T:Newtonsoft.Json.JsonReader"/> to read from.</param> + <param name="objectType">Type of the object.</param> + <param name="existingValue">The existing value of object being read.</param> + <param name="serializer">The calling serializer.</param> + <returns>The object value.</returns> + </member> + <member name="M:Newtonsoft.Json.JsonConverter`1.ReadJson(Newtonsoft.Json.JsonReader,System.Type,`0,System.Boolean,Newtonsoft.Json.JsonSerializer)"> + <summary> + Reads the JSON representation of the object. + </summary> + <param name="reader">The <see cref="T:Newtonsoft.Json.JsonReader"/> to read from.</param> + <param name="objectType">Type of the object.</param> + <param name="existingValue">The existing value of object being read. If there is no existing value then <c>null</c> will be used.</param> + <param name="hasExistingValue">The existing value has a value.</param> + <param name="serializer">The calling serializer.</param> + <returns>The object value.</returns> + </member> + <member name="M:Newtonsoft.Json.JsonConverter`1.CanConvert(System.Type)"> + <summary> + Determines whether this instance can convert the specified object type. + </summary> + <param name="objectType">Type of the object.</param> + <returns> + <c>true</c> if this instance can convert the specified object type; otherwise, <c>false</c>. + </returns> </member> <member name="T:Newtonsoft.Json.JsonConverterAttribute"> <summary> @@ -1941,8 +1915,8 @@ </member> <member name="P:Newtonsoft.Json.JsonConverterAttribute.ConverterParameters"> <summary> - The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/> described by ConverterType. - If null, the default constructor is used. + The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/> described by <see cref="P:Newtonsoft.Json.JsonConverterAttribute.ConverterType"/>. + If <c>null</c>, the default constructor is used. </summary> </member> <member name="M:Newtonsoft.Json.JsonConverterAttribute.#ctor(System.Type)"> @@ -1956,7 +1930,7 @@ Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonConverterAttribute"/> class. </summary> <param name="converterType">Type of the <see cref="T:Newtonsoft.Json.JsonConverter"/>.</param> - <param name="converterParameters">Parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/>. Can be null.</param> + <param name="converterParameters">Parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/>. Can be <c>null</c>.</param> </member> <member name="T:Newtonsoft.Json.JsonConverterCollection"> <summary> @@ -2002,7 +1976,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. </summary> <param name="message">The error message that explains the reason for the exception.</param> - <param name="innerException">The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.</param> + <param name="innerException">The exception that is the cause of the current exception, or <c>null</c> if no inner exception is specified.</param> </member> <member name="M:Newtonsoft.Json.JsonException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)"> <summary> @@ -2010,8 +1984,8 @@ </summary> <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"/> that holds the serialized object data about the exception being thrown.</param> <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext"/> that contains contextual information about the source or destination.</param> - <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is null. </exception> - <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is null or <see cref="P:System.Exception.HResult"/> is zero (0). </exception> + <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is <c>null</c>.</exception> + <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is <c>null</c> or <see cref="P:System.Exception.HResult"/> is zero (0).</exception> </member> <member name="T:Newtonsoft.Json.JsonExtensionDataAttribute"> <summary> @@ -2056,6 +2030,12 @@ </summary> <value>The member serialization.</value> </member> + <member name="P:Newtonsoft.Json.JsonObjectAttribute.ItemNullValueHandling"> + <summary> + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + </summary> + <value>How the object's properties with null values are handled during serialization and deserialization.</value> + </member> <member name="P:Newtonsoft.Json.JsonObjectAttribute.ItemRequired"> <summary> Gets or sets a value that indicates whether the object's properties are required. @@ -2094,13 +2074,15 @@ </member> <member name="P:Newtonsoft.Json.JsonPropertyAttribute.ItemConverterParameters"> <summary> - The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/> described by ItemConverterType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.JsonConverter"/> that exactly matches the number, + The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.JsonConverter"/> described by <see cref="P:Newtonsoft.Json.JsonPropertyAttribute.ItemConverterType"/>. + If <c>null</c>, the default constructor is used. + When non-<c>null</c>, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.JsonConverter"/> that exactly matches the number, order, and type of these parameters. </summary> <example> + <code> [JsonProperty(ItemConverterType = typeof(MyContainerConverter), ItemConverterParameters = new object[] { 123, "Four" })] + </code> </example> </member> <member name="P:Newtonsoft.Json.JsonPropertyAttribute.NamingStrategyType"> @@ -2111,13 +2093,15 @@ </member> <member name="P:Newtonsoft.Json.JsonPropertyAttribute.NamingStrategyParameters"> <summary> - The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> described by NamingStrategyType. - If null, the default constructor is used. - When non-null, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> that exactly matches the number, + The parameter list to use when constructing the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> described by <see cref="P:Newtonsoft.Json.JsonPropertyAttribute.NamingStrategyType"/>. + If <c>null</c>, the default constructor is used. + When non-<c>null</c>, there must be a constructor defined in the <see cref="T:Newtonsoft.Json.Serialization.NamingStrategy"/> that exactly matches the number, order, and type of these parameters. </summary> <example> + <code> [JsonProperty(NamingStrategyType = typeof(MyNamingStrategy), NamingStrategyParameters = new object[] { 123, "Four" })] + </code> </example> </member> <member name="P:Newtonsoft.Json.JsonPropertyAttribute.NullValueHandling"> @@ -2178,13 +2162,13 @@ </member> <member name="P:Newtonsoft.Json.JsonPropertyAttribute.ItemReferenceLoopHandling"> <summary> - 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. </summary> <value>The collection's items reference loop handling.</value> </member> <member name="P:Newtonsoft.Json.JsonPropertyAttribute.ItemTypeNameHandling"> <summary> - 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. </summary> <value>The collection's items type name handling.</value> </member> @@ -2210,6 +2194,105 @@ Represents a reader that provides fast, non-cached, forward-only access to serialized JSON data. </summary> </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns <c>true</c> if the next token was read successfully; <c>false</c> if there are no more tokens to read.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.SkipAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously skips the children of the current token. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsBooleanAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsBytesAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Byte"/>[]. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Byte"/>[]. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsDateTimeAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsDateTimeOffsetAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsDecimalAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsDoubleAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsInt32Async(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonReader.ReadAsStringAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.String"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.String"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> <member name="T:Newtonsoft.Json.JsonReader.State"> <summary> Specifies the state of the reader. @@ -2217,7 +2300,7 @@ </member> <member name="F:Newtonsoft.Json.JsonReader.State.Start"> <summary> - The Read method has not been called. + A <see cref="T:Newtonsoft.Json.JsonReader"/> read method has not been called. </summary> </member> <member name="F:Newtonsoft.Json.JsonReader.State.Complete"> @@ -2252,7 +2335,7 @@ </member> <member name="F:Newtonsoft.Json.JsonReader.State.Closed"> <summary> - The Close method has been called. + The <see cref="M:Newtonsoft.Json.JsonReader.Close"/> method has been called. </summary> </member> <member name="F:Newtonsoft.Json.JsonReader.State.PostValue"> @@ -2267,7 +2350,7 @@ </member> <member name="F:Newtonsoft.Json.JsonReader.State.Constructor"> <summary> - Reader in a constructor. + Reader is in a constructor. </summary> </member> <member name="F:Newtonsoft.Json.JsonReader.State.Error"> @@ -2288,12 +2371,10 @@ </member> <member name="P:Newtonsoft.Json.JsonReader.CloseInput"> <summary> - Gets or sets a value indicating whether the underlying stream or - <see cref="T:System.IO.TextReader"/> 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. </summary> <value> - true to close the underlying stream or <see cref="T:System.IO.TextReader"/> when - the reader is closed; otherwise false. The default is true. + <c>true</c> to close the source when this reader is closed; otherwise <c>false</c>. The default is <c>true</c>. </value> </member> <member name="P:Newtonsoft.Json.JsonReader.SupportMultipleContent"> @@ -2302,7 +2383,8 @@ be read from a continuous stream without erroring. </summary> <value> - true to support reading multiple pieces of JSON content; otherwise false. The default is false. + <c>true</c> to support reading multiple pieces of JSON content; otherwise <c>false</c>. + The default is <c>false</c>. </value> </member> <member name="P:Newtonsoft.Json.JsonReader.QuoteChar"> @@ -2312,22 +2394,22 @@ </member> <member name="P:Newtonsoft.Json.JsonReader.DateTimeZoneHandling"> <summary> - Get or set how <see cref="T:System.DateTime"/> time zones are handling when reading JSON. + Gets or sets how <see cref="T:System.DateTime"/> time zones are handled when reading JSON. </summary> </member> <member name="P:Newtonsoft.Json.JsonReader.DateParseHandling"> <summary> - 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. </summary> </member> <member name="P:Newtonsoft.Json.JsonReader.FloatParseHandling"> <summary> - 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. </summary> </member> <member name="P:Newtonsoft.Json.JsonReader.DateFormatString"> <summary> - 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. </summary> </member> <member name="P:Newtonsoft.Json.JsonReader.MaxDepth"> @@ -2347,7 +2429,7 @@ </member> <member name="P:Newtonsoft.Json.JsonReader.ValueType"> <summary> - Gets The Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. </summary> </member> <member name="P:Newtonsoft.Json.JsonReader.Depth"> @@ -2368,62 +2450,62 @@ </member> <member name="M:Newtonsoft.Json.JsonReader.#ctor"> <summary> - Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonReader"/> class with the specified <see cref="T:System.IO.TextReader"/>. + Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonReader"/> class. </summary> </member> <member name="M:Newtonsoft.Json.JsonReader.Read"> <summary> - Reads the next JSON token from the stream. + Reads the next JSON token from the source. </summary> <returns><c>true</c> if the next token was read successfully; <c>false</c> if there are no more tokens to read.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsInt32"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsString"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.String"/>. + Reads the next JSON token from the source as a <see cref="T:System.String"/>. </summary> <returns>A <see cref="T:System.String"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsBytes"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Byte"/>[]. + Reads the next JSON token from the source as a <see cref="T:System.Byte"/>[]. </summary> - <returns>A <see cref="T:System.Byte"/>[] or a null reference if the next JSON token is null. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Byte"/>[] or <c>null</c> if the next JSON token is null. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsDouble"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsBoolean"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsDecimal"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsDateTime"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.ReadAsDateTimeOffset"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonReader.Skip"> <summary> @@ -2443,25 +2525,29 @@ <param name="newToken">The new token.</param> <param name="value">The value.</param> </member> + <member name="M:Newtonsoft.Json.JsonReader.SetToken(Newtonsoft.Json.JsonToken,System.Object,System.Boolean)"> + <summary> + Sets the current token and value. + </summary> + <param name="newToken">The new token.</param> + <param name="value">The value.</param> + <param name="updateIndex">A flag indicating whether the position index inside an array should be updated.</param> + </member> <member name="M:Newtonsoft.Json.JsonReader.SetStateBasedOnCurrent"> <summary> Sets the state based on current token type. </summary> </member> - <member name="M:Newtonsoft.Json.JsonReader.System#IDisposable#Dispose"> - <summary> - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. - </summary> - </member> <member name="M:Newtonsoft.Json.JsonReader.Dispose(System.Boolean)"> <summary> - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. </summary> <param name="disposing"><c>true</c> to release both managed and unmanaged resources; <c>false</c> to release only unmanaged resources.</param> </member> <member name="M:Newtonsoft.Json.JsonReader.Close"> <summary> - Changes the <see cref="T:Newtonsoft.Json.JsonReader.State"/> to Closed. + Changes the reader's state to <see cref="F:Newtonsoft.Json.JsonReader.State.Closed"/>. + If <see cref="P:Newtonsoft.Json.JsonReader.CloseInput"/> is set to <c>true</c>, the source is also closed. </summary> </member> <member name="T:Newtonsoft.Json.JsonReaderException"> @@ -2505,7 +2591,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. </summary> <param name="message">The error message that explains the reason for the exception.</param> - <param name="innerException">The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.</param> + <param name="innerException">The exception that is the cause of the current exception, or <c>null</c> if no inner exception is specified.</param> </member> <member name="M:Newtonsoft.Json.JsonReaderException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)"> <summary> @@ -2513,12 +2599,23 @@ </summary> <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"/> that holds the serialized object data about the exception being thrown.</param> <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext"/> that contains contextual information about the source or destination.</param> - <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is null. </exception> - <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is null or <see cref="P:System.Exception.HResult"/> is zero (0). </exception> + <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is <c>null</c>.</exception> + <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is <c>null</c> or <see cref="P:System.Exception.HResult"/> is zero (0).</exception> + </member> + <member name="M:Newtonsoft.Json.JsonReaderException.#ctor(System.String,System.String,System.Int32,System.Int32,System.Exception)"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonReaderException"/> class + with a specified error message, JSON path, line number, line position, and a reference to the inner exception that is the cause of this exception. + </summary> + <param name="message">The error message that explains the reason for the exception.</param> + <param name="path">The path to the JSON where the error occurred.</param> + <param name="lineNumber">The line number indicating where the error occurred.</param> + <param name="linePosition">The line position indicating where the error occurred.</param> + <param name="innerException">The exception that is the cause of the current exception, or <c>null</c> if no inner exception is specified.</param> </member> <member name="T:Newtonsoft.Json.JsonRequiredAttribute"> <summary> - Instructs the <see cref="T:Newtonsoft.Json.JsonSerializer"/> to always serialize the member, and require the member has a value. + Instructs the <see cref="T:Newtonsoft.Json.JsonSerializer"/> to always serialize the member, and to require that the member has a value. </summary> </member> <member name="T:Newtonsoft.Json.JsonSerializationException"> @@ -2544,7 +2641,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. </summary> <param name="message">The error message that explains the reason for the exception.</param> - <param name="innerException">The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.</param> + <param name="innerException">The exception that is the cause of the current exception, or <c>null</c> if no inner exception is specified.</param> </member> <member name="M:Newtonsoft.Json.JsonSerializationException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)"> <summary> @@ -2552,8 +2649,8 @@ </summary> <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"/> that holds the serialized object data about the exception being thrown.</param> <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext"/> that contains contextual information about the source or destination.</param> - <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is null. </exception> - <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is null or <see cref="P:System.Exception.HResult"/> is zero (0). </exception> + <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is <c>null</c>.</exception> + <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is <c>null</c> or <see cref="P:System.Exception.HResult"/> is zero (0).</exception> </member> <member name="T:Newtonsoft.Json.JsonSerializer"> <summary> @@ -2573,7 +2670,12 @@ </member> <member name="P:Newtonsoft.Json.JsonSerializer.Binder"> <summary> - Gets or sets the <see cref="T:System.Runtime.Serialization.SerializationBinder"/> used by the serializer when resolving type names. + Gets or sets the <see cref="P:Newtonsoft.Json.JsonSerializer.SerializationBinder"/> used by the serializer when resolving type names. + </summary> + </member> + <member name="P:Newtonsoft.Json.JsonSerializer.SerializationBinder"> + <summary> + Gets or sets the <see cref="T:Newtonsoft.Json.Serialization.ISerializationBinder"/> used by the serializer when resolving type names. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.TraceWriter"> @@ -2591,59 +2693,76 @@ <member name="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"> <summary> Gets or sets how type name writing and reading is handled by the serializer. + The default value is <see cref="F:Newtonsoft.Json.TypeNameHandling.None" />. </summary> <remarks> <see cref="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"/> should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom <see cref="T:System.Runtime.Serialization.SerializationBinder"/> - when deserializing with a value other than <c>TypeNameHandling.None</c>. + Incoming types should be validated with a custom <see cref="P:Newtonsoft.Json.JsonSerializer.SerializationBinder"/> + when deserializing with a value other than <see cref="F:Newtonsoft.Json.TypeNameHandling.None"/>. </remarks> </member> <member name="P:Newtonsoft.Json.JsonSerializer.TypeNameAssemblyFormat"> <summary> Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is <see cref="F:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle.Simple" />. + </summary> + <value>The type name assembly format.</value> + </member> + <member name="P:Newtonsoft.Json.JsonSerializer.TypeNameAssemblyFormatHandling"> + <summary> + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is <see cref="F:Newtonsoft.Json.TypeNameAssemblyFormatHandling.Simple" />. </summary> <value>The type name assembly format.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializer.PreserveReferencesHandling"> <summary> Gets or sets how object references are preserved by the serializer. + The default value is <see cref="F:Newtonsoft.Json.PreserveReferencesHandling.None" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.ReferenceLoopHandling"> <summary> - 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. + The default value is <see cref="F:Newtonsoft.Json.ReferenceLoopHandling.Error" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.MissingMemberHandling"> <summary> - 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. + The default value is <see cref="F:Newtonsoft.Json.MissingMemberHandling.Ignore" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.NullValueHandling"> <summary> - Get or set how null values are handled during serialization and deserialization. + Gets or sets how null values are handled during serialization and deserialization. + The default value is <see cref="F:Newtonsoft.Json.NullValueHandling.Include" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.DefaultValueHandling"> <summary> - Get or set how null default are handled during serialization and deserialization. + Gets or sets how default values are handled during serialization and deserialization. + The default value is <see cref="F:Newtonsoft.Json.DefaultValueHandling.Include" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.ObjectCreationHandling"> <summary> Gets or sets how objects are created during deserialization. + The default value is <see cref="F:Newtonsoft.Json.ObjectCreationHandling.Auto" />. </summary> <value>The object creation handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializer.ConstructorHandling"> <summary> Gets or sets how constructors are used during deserialization. + The default value is <see cref="F:Newtonsoft.Json.ConstructorHandling.Default" />. </summary> <value>The constructor handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializer.MetadataPropertyHandling"> <summary> Gets or sets how metadata properties are used during deserialization. + The default value is <see cref="F:Newtonsoft.Json.MetadataPropertyHandling.Default" />. </summary> <value>The metadata properties handling.</value> </member> @@ -2668,58 +2787,71 @@ <member name="P:Newtonsoft.Json.JsonSerializer.Formatting"> <summary> Indicates how JSON text output is formatted. + The default value is <see cref="F:Newtonsoft.Json.Formatting.None" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.DateFormatHandling"> <summary> - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. + The default value is <see cref="F:Newtonsoft.Json.DateFormatHandling.IsoDateFormat" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.DateTimeZoneHandling"> <summary> - Get or set how <see cref="T:System.DateTime"/> time zones are handling during serialization and deserialization. + Gets or sets how <see cref="T:System.DateTime"/> time zones are handled during serialization and deserialization. + The default value is <see cref="F:Newtonsoft.Json.DateTimeZoneHandling.RoundtripKind" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.DateParseHandling"> <summary> - 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. <c>"\/Date(1198908717056)\/"</c> and <c>"2012-03-21T05:40Z"</c>, are parsed when reading JSON. + The default value is <see cref="F:Newtonsoft.Json.DateParseHandling.DateTime" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.FloatParseHandling"> <summary> - 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. + The default value is <see cref="F:Newtonsoft.Json.FloatParseHandling.Double" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.FloatFormatHandling"> <summary> - Get or set how special floating point numbers, e.g. <see cref="F:System.Double.NaN"/>, + Gets or sets how special floating point numbers, e.g. <see cref="F:System.Double.NaN"/>, <see cref="F:System.Double.PositiveInfinity"/> and <see cref="F:System.Double.NegativeInfinity"/>, are written as JSON text. + The default value is <see cref="F:Newtonsoft.Json.FloatFormatHandling.String" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.StringEscapeHandling"> <summary> - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. + The default value is <see cref="F:Newtonsoft.Json.StringEscapeHandling.Default" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.DateFormatString"> <summary> - Get or set how <see cref="T:System.DateTime"/> and <see cref="T:System.DateTimeOffset"/> values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how <see cref="T:System.DateTime"/> and <see cref="T:System.DateTimeOffset"/> values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is <c>"yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK"</c>. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.Culture"> <summary> - Gets or sets the culture used when reading JSON. Defaults to <see cref="P:System.Globalization.CultureInfo.InvariantCulture"/>. + Gets or sets the culture used when reading JSON. + The default value is <see cref="P:System.Globalization.CultureInfo.InvariantCulture"/>. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.MaxDepth"> <summary> Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a <see cref="T:Newtonsoft.Json.JsonReaderException"/>. + A null value means there is no maximum. + The default value is <c>null</c>. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializer.CheckAdditionalContent"> <summary> Gets a value indicating whether there will be a check for additional JSON content after deserializing an object. + The default value is <c>false</c>. </summary> <value> <c>true</c> if there will be a check for additional JSON content after deserializing an object; otherwise, <c>false</c>. @@ -2831,7 +2963,7 @@ <member name="M:Newtonsoft.Json.JsonSerializer.Serialize(System.IO.TextWriter,System.Object)"> <summary> Serializes the specified <see cref="T:System.Object"/> and writes the JSON structure - to a <c>Stream</c> using the specified <see cref="T:System.IO.TextWriter"/>. + using the specified <see cref="T:System.IO.TextWriter"/>. </summary> <param name="textWriter">The <see cref="T:System.IO.TextWriter"/> used to write the JSON structure.</param> <param name="value">The <see cref="T:System.Object"/> to serialize.</param> @@ -2839,33 +2971,33 @@ <member name="M:Newtonsoft.Json.JsonSerializer.Serialize(Newtonsoft.Json.JsonWriter,System.Object,System.Type)"> <summary> Serializes the specified <see cref="T:System.Object"/> and writes the JSON structure - to a <c>Stream</c> using the specified <see cref="T:System.IO.TextWriter"/>. + using the specified <see cref="T:Newtonsoft.Json.JsonWriter"/>. </summary> <param name="jsonWriter">The <see cref="T:Newtonsoft.Json.JsonWriter"/> used to write the JSON structure.</param> <param name="value">The <see cref="T:System.Object"/> to serialize.</param> <param name="objectType"> The type of the value being serialized. - This parameter is used when <see cref="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"/> 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 <see cref="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"/> is <see cref="F:Newtonsoft.Json.TypeNameHandling.Auto"/> to write out the type name if the type of the value does not match. + Specifying the type is optional. </param> </member> <member name="M:Newtonsoft.Json.JsonSerializer.Serialize(System.IO.TextWriter,System.Object,System.Type)"> <summary> Serializes the specified <see cref="T:System.Object"/> and writes the JSON structure - to a <c>Stream</c> using the specified <see cref="T:System.IO.TextWriter"/>. + using the specified <see cref="T:System.IO.TextWriter"/>. </summary> <param name="textWriter">The <see cref="T:System.IO.TextWriter"/> used to write the JSON structure.</param> <param name="value">The <see cref="T:System.Object"/> to serialize.</param> <param name="objectType"> The type of the value being serialized. This parameter is used when <see cref="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"/> 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. </param> </member> <member name="M:Newtonsoft.Json.JsonSerializer.Serialize(Newtonsoft.Json.JsonWriter,System.Object)"> <summary> Serializes the specified <see cref="T:System.Object"/> and writes the JSON structure - to a <c>Stream</c> using the specified <see cref="T:Newtonsoft.Json.JsonWriter"/>. + using the specified <see cref="T:Newtonsoft.Json.JsonWriter"/>. </summary> <param name="jsonWriter">The <see cref="T:Newtonsoft.Json.JsonWriter"/> used to write the JSON structure.</param> <param name="value">The <see cref="T:System.Object"/> to serialize.</param> @@ -2877,31 +3009,36 @@ </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.ReferenceLoopHandling"> <summary> - 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. + The default value is <see cref="F:Newtonsoft.Json.ReferenceLoopHandling.Error" />. </summary> <value>Reference loop handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.MissingMemberHandling"> <summary> Gets or sets how missing members (e.g. JSON contains a property that isn't a member on the object) are handled during deserialization. + The default value is <see cref="F:Newtonsoft.Json.MissingMemberHandling.Ignore" />. </summary> <value>Missing member handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.ObjectCreationHandling"> <summary> Gets or sets how objects are created during deserialization. + The default value is <see cref="F:Newtonsoft.Json.ObjectCreationHandling.Auto" />. </summary> <value>The object creation handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.NullValueHandling"> <summary> Gets or sets how null values are handled during serialization and deserialization. + The default value is <see cref="F:Newtonsoft.Json.NullValueHandling.Include" />. </summary> <value>Null value handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.DefaultValueHandling"> <summary> - 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 is <see cref="F:Newtonsoft.Json.DefaultValueHandling.Include" />. </summary> <value>The default value handling.</value> </member> @@ -2914,35 +3051,47 @@ <member name="P:Newtonsoft.Json.JsonSerializerSettings.PreserveReferencesHandling"> <summary> Gets or sets how object references are preserved by the serializer. + The default value is <see cref="F:Newtonsoft.Json.PreserveReferencesHandling.None" />. </summary> <value>The preserve references handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.TypeNameHandling"> <summary> Gets or sets how type name writing and reading is handled by the serializer. + The default value is <see cref="F:Newtonsoft.Json.TypeNameHandling.None" />. </summary> <remarks> <see cref="P:Newtonsoft.Json.JsonSerializerSettings.TypeNameHandling"/> should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom <see cref="T:System.Runtime.Serialization.SerializationBinder"/> - when deserializing with a value other than <c>TypeNameHandling.None</c>. + Incoming types should be validated with a custom <see cref="P:Newtonsoft.Json.JsonSerializerSettings.SerializationBinder"/> + when deserializing with a value other than <see cref="F:Newtonsoft.Json.TypeNameHandling.None"/>. </remarks> <value>The type name handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.MetadataPropertyHandling"> <summary> Gets or sets how metadata properties are used during deserialization. + The default value is <see cref="F:Newtonsoft.Json.MetadataPropertyHandling.Default" />. </summary> <value>The metadata properties handling.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.TypeNameAssemblyFormat"> <summary> Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is <see cref="F:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle.Simple" />. + </summary> + <value>The type name assembly format.</value> + </member> + <member name="P:Newtonsoft.Json.JsonSerializerSettings.TypeNameAssemblyFormatHandling"> + <summary> + Gets or sets how a type name assembly is written and resolved by the serializer. + The default value is <see cref="F:Newtonsoft.Json.TypeNameAssemblyFormatHandling.Simple" />. </summary> <value>The type name assembly format.</value> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.ConstructorHandling"> <summary> Gets or sets how constructors are used during deserialization. + The default value is <see cref="F:Newtonsoft.Json.ConstructorHandling.Default" />. </summary> <value>The constructor handling.</value> </member> @@ -2979,7 +3128,13 @@ </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.Binder"> <summary> - Gets or sets the <see cref="T:System.Runtime.Serialization.SerializationBinder"/> used by the serializer when resolving type names. + Gets or sets the <see cref="P:Newtonsoft.Json.JsonSerializerSettings.SerializationBinder"/> used by the serializer when resolving type names. + </summary> + <value>The binder.</value> + </member> + <member name="P:Newtonsoft.Json.JsonSerializerSettings.SerializationBinder"> + <summary> + Gets or sets the <see cref="T:Newtonsoft.Json.Serialization.ISerializationBinder"/> used by the serializer when resolving type names. </summary> <value>The binder.</value> </member> @@ -2997,59 +3152,72 @@ </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.DateFormatString"> <summary> - Get or set how <see cref="T:System.DateTime"/> and <see cref="T:System.DateTimeOffset"/> values are formatted when writing JSON text, and the expected date format when reading JSON text. + Gets or sets how <see cref="T:System.DateTime"/> and <see cref="T:System.DateTimeOffset"/> values are formatted when writing JSON text, + and the expected date format when reading JSON text. + The default value is <c>"yyyy'-'MM'-'dd'T'HH':'mm':'ss.FFFFFFFK"</c>. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.MaxDepth"> <summary> Gets or sets the maximum depth allowed when reading JSON. Reading past this depth will throw a <see cref="T:Newtonsoft.Json.JsonReaderException"/>. + A null value means there is no maximum. + The default value is <c>null</c>. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.Formatting"> <summary> Indicates how JSON text output is formatted. + The default value is <see cref="F:Newtonsoft.Json.Formatting.None" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.DateFormatHandling"> <summary> - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. + The default value is <see cref="F:Newtonsoft.Json.DateFormatHandling.IsoDateFormat" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.DateTimeZoneHandling"> <summary> - Get or set how <see cref="T:System.DateTime"/> time zones are handling during serialization and deserialization. + Gets or sets how <see cref="T:System.DateTime"/> time zones are handled during serialization and deserialization. + The default value is <see cref="F:Newtonsoft.Json.DateTimeZoneHandling.RoundtripKind" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.DateParseHandling"> <summary> - 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. <c>"\/Date(1198908717056)\/"</c> and <c>"2012-03-21T05:40Z"</c>, are parsed when reading JSON. + The default value is <see cref="F:Newtonsoft.Json.DateParseHandling.DateTime" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.FloatFormatHandling"> <summary> - Get or set how special floating point numbers, e.g. <see cref="F:System.Double.NaN"/>, + Gets or sets how special floating point numbers, e.g. <see cref="F:System.Double.NaN"/>, <see cref="F:System.Double.PositiveInfinity"/> and <see cref="F:System.Double.NegativeInfinity"/>, are written as JSON. + The default value is <see cref="F:Newtonsoft.Json.FloatFormatHandling.String" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.FloatParseHandling"> <summary> - 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. + The default value is <see cref="F:Newtonsoft.Json.FloatParseHandling.Double" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.StringEscapeHandling"> <summary> - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. + The default value is <see cref="F:Newtonsoft.Json.StringEscapeHandling.Default" />. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.Culture"> <summary> - Gets or sets the culture used when reading JSON. Defaults to <see cref="P:System.Globalization.CultureInfo.InvariantCulture"/>. + Gets or sets the culture used when reading JSON. + The default value is <see cref="P:System.Globalization.CultureInfo.InvariantCulture"/>. </summary> </member> <member name="P:Newtonsoft.Json.JsonSerializerSettings.CheckAdditionalContent"> <summary> Gets a value indicating whether there will be a check for additional content after deserializing an object. + The default value is <c>false</c>. </summary> <value> <c>true</c> if there will be a check for additional content after deserializing an object; otherwise, <c>false</c>. @@ -3065,11 +3233,101 @@ Represents a reader that provides fast, non-cached, forward-only access to JSON text data. </summary> </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns <c>true</c> if the next token was read successfully; <c>false</c> if there are no more tokens to read.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsBooleanAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsBytesAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Byte"/>[]. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Byte"/>[]. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDateTimeAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDateTimeOffsetAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDecimalAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDoubleAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsInt32Async(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsStringAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously reads the next JSON token from the source as a <see cref="T:System.String"/>. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous read. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns the <see cref="T:System.String"/>. This result will be <c>null</c> at the end of an array.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> <member name="M:Newtonsoft.Json.JsonTextReader.#ctor(System.IO.TextReader)"> <summary> - Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonReader"/> class with the specified <see cref="T:System.IO.TextReader"/>. + Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonTextReader"/> class with the specified <see cref="T:System.IO.TextReader"/>. </summary> - <param name="reader">The <c>TextReader</c> containing the XML data to read.</param> + <param name="reader">The <see cref="T:System.IO.TextReader"/> containing the JSON data to read.</param> </member> <member name="P:Newtonsoft.Json.JsonTextReader.ArrayPool"> <summary> @@ -3078,7 +3336,7 @@ </member> <member name="M:Newtonsoft.Json.JsonTextReader.Read"> <summary> - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/>. </summary> <returns> <c>true</c> if the next token was read successfully; <c>false</c> if there are no more tokens to read. @@ -3086,55 +3344,56 @@ </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsInt32"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDateTime"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsString"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.String"/>. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.String"/>. </summary> <returns>A <see cref="T:System.String"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsBytes"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Byte"/>[]. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.Byte"/>[]. </summary> - <returns>A <see cref="T:System.Byte"/>[] or a null reference if the next JSON token is null. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Byte"/>[] or <c>null</c> if the next JSON token is null. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsBoolean"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDateTimeOffset"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDecimal"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.ReadAsDouble"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:System.IO.TextReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonTextReader.Close"> <summary> - Changes the state to closed. + Changes the reader's state to <see cref="F:Newtonsoft.Json.JsonReader.State.Closed"/>. + If <see cref="P:Newtonsoft.Json.JsonReader.CloseInput"/> is set to <c>true</c>, the underlying <see cref="T:System.IO.TextReader"/> is also closed. </summary> </member> <member name="M:Newtonsoft.Json.JsonTextReader.HasLineInfo"> @@ -3142,7 +3401,7 @@ Gets a value indicating whether the class can return line information. </summary> <returns> - <c>true</c> if LineNumber and LinePosition can be provided; otherwise, <c>false</c>. + <c>true</c> if <see cref="P:Newtonsoft.Json.JsonTextReader.LineNumber"/> and <see cref="P:Newtonsoft.Json.JsonTextReader.LinePosition"/> can be provided; otherwise, <c>false</c>. </returns> </member> <member name="P:Newtonsoft.Json.JsonTextReader.LineNumber"> @@ -3150,7 +3409,7 @@ Gets the current line number. </summary> <value> - 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, <see cref="M:Newtonsoft.Json.JsonTextReader.HasLineInfo"/> returns <c>false</c>). </value> </member> <member name="P:Newtonsoft.Json.JsonTextReader.LinePosition"> @@ -3158,13 +3417,592 @@ Gets the current line position. </summary> <value> - 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, <see cref="M:Newtonsoft.Json.JsonTextReader.HasLineInfo"/> returns <c>false</c>). </value> </member> <member name="T:Newtonsoft.Json.JsonTextWriter"> <summary> Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. </summary> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.FlushAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueDelimiterAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the JSON value delimiter. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteEndAsync(Newtonsoft.Json.JsonToken,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the specified end token. + </summary> + <param name="token">The end token to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.CloseAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously closes this writer. + If <see cref="P:Newtonsoft.Json.JsonWriter.CloseOutput"/> is set to <c>true</c>, the destination is also closed. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteEndAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of the current JSON object or array. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteIndentAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes indent characters. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteIndentSpaceAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes an indent space. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteRawAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes raw JSON without changing the writer's state. + </summary> + <param name="json">The raw JSON to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteNullAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a null value. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WritePropertyNameAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the property name of a name/value pair of a JSON object. + </summary> + <param name="name">The name of the property.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WritePropertyNameAsync(System.String,System.Boolean,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the property name of a name/value pair of a JSON object. + </summary> + <param name="name">The name of the property.</param> + <param name="escape">A flag to indicate whether the text should be escaped when it is written as a JSON property name.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteStartArrayAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the beginning of a JSON array. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteStartObjectAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the beginning of a JSON object. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteStartConstructorAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the start of a constructor with the given name. + </summary> + <param name="name">The name of the constructor.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteUndefinedAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes an undefined value. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteWhitespaceAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the given white space. + </summary> + <param name="ws">The string of white space characters.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Boolean,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Boolean},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Boolean"/> value. + </summary> + <param name="value">The <see cref="T:System.Boolean"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Byte,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Byte"/> value. + </summary> + <param name="value">The <see cref="T:System.Byte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Byte},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Byte[],System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Byte"/>[] value. + </summary> + <param name="value">The <see cref="T:System.Byte"/>[] value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Char,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Char"/> value. + </summary> + <param name="value">The <see cref="T:System.Char"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Char},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Char"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Char"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.DateTime,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.DateTime"/> value. + </summary> + <param name="value">The <see cref="T:System.DateTime"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.DateTime},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.DateTimeOffset,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.DateTimeOffset"/> value. + </summary> + <param name="value">The <see cref="T:System.DateTimeOffset"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.DateTimeOffset},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Decimal,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Decimal"/> value. + </summary> + <param name="value">The <see cref="T:System.Decimal"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Decimal},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Double,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Double"/> value. + </summary> + <param name="value">The <see cref="T:System.Double"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Double},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Single,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Single"/> value. + </summary> + <param name="value">The <see cref="T:System.Single"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Single},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Guid,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Guid"/> value. + </summary> + <param name="value">The <see cref="T:System.Guid"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Guid},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Int32,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Int32"/> value. + </summary> + <param name="value">The <see cref="T:System.Int32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Int32},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Int64,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Int64"/> value. + </summary> + <param name="value">The <see cref="T:System.Int64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Int64},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Object,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Object"/> value. + </summary> + <param name="value">The <see cref="T:System.Object"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.SByte,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.SByte"/> value. + </summary> + <param name="value">The <see cref="T:System.SByte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.SByte},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Int16,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Int16"/> value. + </summary> + <param name="value">The <see cref="T:System.Int16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.Int16},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.String"/> value. + </summary> + <param name="value">The <see cref="T:System.String"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.TimeSpan,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.TimeSpan"/> value. + </summary> + <param name="value">The <see cref="T:System.TimeSpan"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.TimeSpan},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.UInt32,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.UInt32"/> value. + </summary> + <param name="value">The <see cref="T:System.UInt32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.UInt32},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.UInt64,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.UInt64"/> value. + </summary> + <param name="value">The <see cref="T:System.UInt64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.UInt64},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Uri,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Uri"/> value. + </summary> + <param name="value">The <see cref="T:System.Uri"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.UInt16,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.UInt16"/> value. + </summary> + <param name="value">The <see cref="T:System.UInt16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValueAsync(System.Nullable{System.UInt16},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteCommentAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a comment <c>/*...*/</c> containing the specified text. + </summary> + <param name="text">Text to place inside the comment.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteEndArrayAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of an array. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteEndConstructorAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of a constructor. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteEndObjectAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of a JSON object. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonTextWriter.WriteRawValueAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + </summary> + <param name="json">The raw JSON to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>Derived classes must override this method to get asynchronous behaviour. Otherwise it will + execute synchronously, returning an already-completed task.</remarks> </member> <member name="P:Newtonsoft.Json.JsonTextWriter.ArrayPool"> <summary> @@ -3173,7 +4011,7 @@ </member> <member name="P:Newtonsoft.Json.JsonTextWriter.Indentation"> <summary> - Gets or sets how many IndentChars to write for each level in the hierarchy when <see cref="T:Newtonsoft.Json.Formatting"/> is set to <c>Formatting.Indented</c>. + Gets or sets how many <see cref="P:Newtonsoft.Json.JsonTextWriter.IndentChar"/>s to write for each level in the hierarchy when <see cref="P:Newtonsoft.Json.JsonWriter.Formatting"/> is set to <see cref="F:Newtonsoft.Json.Formatting.Indented"/>. </summary> </member> <member name="P:Newtonsoft.Json.JsonTextWriter.QuoteChar"> @@ -3183,7 +4021,7 @@ </member> <member name="P:Newtonsoft.Json.JsonTextWriter.IndentChar"> <summary> - Gets or sets which character to use for indenting when <see cref="T:Newtonsoft.Json.Formatting"/> is set to <c>Formatting.Indented</c>. + Gets or sets which character to use for indenting when <see cref="P:Newtonsoft.Json.JsonWriter.Formatting"/> is set to <see cref="F:Newtonsoft.Json.Formatting.Indented"/>. </summary> </member> <member name="P:Newtonsoft.Json.JsonTextWriter.QuoteName"> @@ -3193,18 +4031,20 @@ </member> <member name="M:Newtonsoft.Json.JsonTextWriter.#ctor(System.IO.TextWriter)"> <summary> - Creates an instance of the <c>JsonWriter</c> class using the specified <see cref="T:System.IO.TextWriter"/>. + Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonTextWriter"/> class using the specified <see cref="T:System.IO.TextWriter"/>. </summary> - <param name="textWriter">The <c>TextWriter</c> to write to.</param> + <param name="textWriter">The <see cref="T:System.IO.TextWriter"/> to write to.</param> </member> <member name="M:Newtonsoft.Json.JsonTextWriter.Flush"> <summary> - 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 <see cref="T:System.IO.TextWriter"/> and also flushes the underlying <see cref="T:System.IO.TextWriter"/>. </summary> </member> <member name="M:Newtonsoft.Json.JsonTextWriter.Close"> <summary> - Closes this stream and the underlying stream. + Closes this writer. + If <see cref="P:Newtonsoft.Json.JsonWriter.CloseOutput"/> is set to <c>true</c>, the underlying <see cref="T:System.IO.TextWriter"/> is also closed. + If <see cref="P:Newtonsoft.Json.JsonWriter.AutoCompleteOnClose"/> is set to <c>true</c>, the JSON is auto-completed. </summary> </member> <member name="M:Newtonsoft.Json.JsonTextWriter.WriteStartObject"> @@ -3318,9 +4158,9 @@ </member> <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValue(System.Nullable{System.Single})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValue(System.Double)"> <summary> @@ -3330,9 +4170,9 @@ </member> <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValue(System.Nullable{System.Double})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonTextWriter.WriteValue(System.Boolean)"> <summary> @@ -3414,13 +4254,13 @@ </member> <member name="M:Newtonsoft.Json.JsonTextWriter.WriteComment(System.String)"> <summary> - Writes out a comment <code>/*...*/</code> containing the specified text. + Writes a comment <c>/*...*/</c> containing the specified text. </summary> <param name="text">Text to place inside the comment.</param> </member> <member name="M:Newtonsoft.Json.JsonTextWriter.WriteWhitespace(System.String)"> <summary> - Writes out the given white space. + Writes the given white space. </summary> <param name="ws">The string of white space characters.</param> </member> @@ -3431,7 +4271,7 @@ </member> <member name="F:Newtonsoft.Json.JsonToken.None"> <summary> - This is returned by the <see cref="T:Newtonsoft.Json.JsonReader"/> if a <see cref="M:Newtonsoft.Json.JsonReader.Read"/> method has not been called. + This is returned by the <see cref="T:Newtonsoft.Json.JsonReader"/> if a read method has not been called. </summary> </member> <member name="F:Newtonsoft.Json.JsonToken.StartObject"> @@ -3565,7 +4405,7 @@ </member> <member name="P:Newtonsoft.Json.JsonValidatingReader.ValueType"> <summary> - Gets the Common Language Runtime (CLR) type for the current JSON token. + Gets the .NET type for the current JSON token. </summary> <value></value> </member> @@ -3588,59 +4428,65 @@ </summary> <value>The <see cref="T:Newtonsoft.Json.JsonReader"/> specified in the constructor.</value> </member> + <member name="M:Newtonsoft.Json.JsonValidatingReader.Close"> + <summary> + Changes the reader's state to <see cref="F:Newtonsoft.Json.JsonReader.State.Closed"/>. + If <see cref="P:Newtonsoft.Json.JsonReader.CloseInput"/> is set to <c>true</c>, the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> is also closed. + </summary> + </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsInt32"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsBytes"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Byte"/>[]. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.Byte"/>[]. </summary> <returns> - A <see cref="T:System.Byte"/>[] or a null reference if the next JSON token is null. + A <see cref="T:System.Byte"/>[] or <c>null</c> if the next JSON token is null. </returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsDecimal"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsDouble"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsBoolean"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsString"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.String"/>. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.String"/>. </summary> <returns>A <see cref="T:System.String"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsDateTime"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>. This method will return <c>null</c> at the end of an array.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. This method will return <c>null</c> at the end of an array.</returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.ReadAsDateTimeOffset"> <summary> - Reads the next JSON token from the stream as a <see cref="T:System.Nullable`1"/>. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/> as a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. </summary> - <returns>A <see cref="T:System.Nullable`1"/>.</returns> + <returns>A <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>.</returns> </member> <member name="M:Newtonsoft.Json.JsonValidatingReader.Read"> <summary> - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> <returns> <c>true</c> if the next token was read successfully; <c>false</c> if there are no more tokens to read. @@ -3651,14 +4497,656 @@ Represents a writer that provides a fast, non-cached, forward-only way of generating JSON data. </summary> </member> + <member name="M:Newtonsoft.Json.JsonWriter.CloseAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously closes this writer. + If <see cref="P:Newtonsoft.Json.JsonWriter.CloseOutput"/> is set to <c>true</c>, the destination is also closed. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.FlushAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously flushes whatever is in the buffer to the destination and also flushes the destination. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteEndAsync(Newtonsoft.Json.JsonToken,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the specified end token. + </summary> + <param name="token">The end token to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteIndentAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes indent characters. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueDelimiterAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the JSON value delimiter. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteIndentSpaceAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes an indent space. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteRawAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes raw JSON without changing the writer's state. + </summary> + <param name="json">The raw JSON to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteEndAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of the current JSON object or array. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteEndArrayAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of an array. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteEndConstructorAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of a constructor. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteEndObjectAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the end of a JSON object. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteNullAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a null value. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WritePropertyNameAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the property name of a name/value pair of a JSON object. + </summary> + <param name="name">The name of the property.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WritePropertyNameAsync(System.String,System.Boolean,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the property name of a name/value pair of a JSON object. + </summary> + <param name="name">The name of the property.</param> + <param name="escape">A flag to indicate whether the text should be escaped when it is written as a JSON property name.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteStartArrayAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the beginning of a JSON array. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteCommentAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a comment <c>/*...*/</c> containing the specified text. + </summary> + <param name="text">Text to place inside the comment.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteRawValueAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes raw JSON where a value is expected and updates the writer's state. + </summary> + <param name="json">The raw JSON to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteStartConstructorAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the start of a constructor with the given name. + </summary> + <param name="name">The name of the constructor.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteStartObjectAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the beginning of a JSON object. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteTokenAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the current <see cref="T:Newtonsoft.Json.JsonReader"/> token. + </summary> + <param name="reader">The <see cref="T:Newtonsoft.Json.JsonReader"/> to read the token from.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteTokenAsync(Newtonsoft.Json.JsonReader,System.Boolean,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the current <see cref="T:Newtonsoft.Json.JsonReader"/> token. + </summary> + <param name="reader">The <see cref="T:Newtonsoft.Json.JsonReader"/> to read the token from.</param> + <param name="writeChildren">A flag indicating whether the current token's children should be written.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteTokenAsync(Newtonsoft.Json.JsonToken,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the <see cref="T:Newtonsoft.Json.JsonToken"/> token and its value. + </summary> + <param name="token">The <see cref="T:Newtonsoft.Json.JsonToken"/> to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteTokenAsync(Newtonsoft.Json.JsonToken,System.Object,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the <see cref="T:Newtonsoft.Json.JsonToken"/> token and its value. + </summary> + <param name="token">The <see cref="T:Newtonsoft.Json.JsonToken"/> to write.</param> + <param name="value"> + The value to write. + A value is only required for tokens that have an associated value, e.g. the <see cref="T:System.String"/> property name for <see cref="F:Newtonsoft.Json.JsonToken.PropertyName"/>. + <c>null</c> can be passed to the method for tokens that don't have a value, e.g. <see cref="F:Newtonsoft.Json.JsonToken.StartObject"/>. + </param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Boolean,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Boolean},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Boolean"/> value. + </summary> + <param name="value">The <see cref="T:System.Boolean"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Byte,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Byte"/> value. + </summary> + <param name="value">The <see cref="T:System.Byte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Byte},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Byte[],System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Byte"/>[] value. + </summary> + <param name="value">The <see cref="T:System.Byte"/>[] value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Char,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Char"/> value. + </summary> + <param name="value">The <see cref="T:System.Char"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Char},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Char"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Char"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.DateTime,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.DateTime"/> value. + </summary> + <param name="value">The <see cref="T:System.DateTime"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.DateTime},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.DateTimeOffset,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.DateTimeOffset"/> value. + </summary> + <param name="value">The <see cref="T:System.DateTimeOffset"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.DateTimeOffset},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Decimal,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Decimal"/> value. + </summary> + <param name="value">The <see cref="T:System.Decimal"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Decimal},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Double,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Double"/> value. + </summary> + <param name="value">The <see cref="T:System.Double"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Double},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Single,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Single"/> value. + </summary> + <param name="value">The <see cref="T:System.Single"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Single},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Guid,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Guid"/> value. + </summary> + <param name="value">The <see cref="T:System.Guid"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Guid},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Int32,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Int32"/> value. + </summary> + <param name="value">The <see cref="T:System.Int32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Int32},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Int64,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Int64"/> value. + </summary> + <param name="value">The <see cref="T:System.Int64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Int64},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Object,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Object"/> value. + </summary> + <param name="value">The <see cref="T:System.Object"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.SByte,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.SByte"/> value. + </summary> + <param name="value">The <see cref="T:System.SByte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.SByte},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Int16,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Int16"/> value. + </summary> + <param name="value">The <see cref="T:System.Int16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.Int16},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.String"/> value. + </summary> + <param name="value">The <see cref="T:System.String"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.TimeSpan,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.TimeSpan"/> value. + </summary> + <param name="value">The <see cref="T:System.TimeSpan"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.TimeSpan},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.UInt32,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.UInt32"/> value. + </summary> + <param name="value">The <see cref="T:System.UInt32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.UInt32},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.UInt64,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.UInt64"/> value. + </summary> + <param name="value">The <see cref="T:System.UInt64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.UInt64},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Uri,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Uri"/> value. + </summary> + <param name="value">The <see cref="T:System.Uri"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.UInt16,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.UInt16"/> value. + </summary> + <param name="value">The <see cref="T:System.UInt16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteValueAsync(System.Nullable{System.UInt16},System.Threading.CancellationToken)"> + <summary> + Asynchronously writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/> value. + </summary> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/> value to write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteUndefinedAsync(System.Threading.CancellationToken)"> + <summary> + Asynchronously writes an undefined value. + </summary> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.WriteWhitespaceAsync(System.String,System.Threading.CancellationToken)"> + <summary> + Asynchronously writes the given white space. + </summary> + <param name="ws">The string of white space characters.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> + <member name="M:Newtonsoft.Json.JsonWriter.SetWriteStateAsync(Newtonsoft.Json.JsonToken,System.Object,System.Threading.CancellationToken)"> + <summary> + Asynchronously ets the state of the <see cref="T:Newtonsoft.Json.JsonWriter"/>. + </summary> + <param name="token">The <see cref="T:Newtonsoft.Json.JsonToken"/> being written.</param> + <param name="value">The value being written.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous operation.</returns> + <remarks>The default behaviour is to execute synchronously, returning an already-completed task. Derived + classes can override this behaviour for true asynchronicity.</remarks> + </member> <member name="P:Newtonsoft.Json.JsonWriter.CloseOutput"> <summary> - Gets or sets a value indicating whether the underlying stream or - <see cref="T:System.IO.TextReader"/> 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. </summary> <value> - true to close the underlying stream or <see cref="T:System.IO.TextReader"/> when - the writer is closed; otherwise false. The default is true. + <c>true</c> to close the destination when this writer is closed; otherwise <c>false</c>. The default is <c>true</c>. + </value> + </member> + <member name="P:Newtonsoft.Json.JsonWriter.AutoCompleteOnClose"> + <summary> + Gets or sets a value indicating whether the JSON should be auto-completed when this writer is closed. + </summary> + <value> + <c>true</c> to auto-complete the JSON when this writer is closed; otherwise <c>false</c>. The default is <c>true</c>. </value> </member> <member name="P:Newtonsoft.Json.JsonWriter.Top"> @@ -3679,34 +5167,34 @@ </member> <member name="P:Newtonsoft.Json.JsonWriter.Formatting"> <summary> - Indicates how JSON text output is formatted. + Gets or sets a value indicating how JSON text output should be formatted. </summary> </member> <member name="P:Newtonsoft.Json.JsonWriter.DateFormatHandling"> <summary> - Get or set how dates are written to JSON text. + Gets or sets how dates are written to JSON text. </summary> </member> <member name="P:Newtonsoft.Json.JsonWriter.DateTimeZoneHandling"> <summary> - Get or set how <see cref="T:System.DateTime"/> time zones are handling when writing JSON text. + Gets or sets how <see cref="T:System.DateTime"/> time zones are handled when writing JSON text. </summary> </member> <member name="P:Newtonsoft.Json.JsonWriter.StringEscapeHandling"> <summary> - Get or set how strings are escaped when writing JSON text. + Gets or sets how strings are escaped when writing JSON text. </summary> </member> <member name="P:Newtonsoft.Json.JsonWriter.FloatFormatHandling"> <summary> - Get or set how special floating point numbers, e.g. <see cref="F:System.Double.NaN"/>, + Gets or sets how special floating point numbers, e.g. <see cref="F:System.Double.NaN"/>, <see cref="F:System.Double.PositiveInfinity"/> and <see cref="F:System.Double.NegativeInfinity"/>, are written to JSON text. </summary> </member> <member name="P:Newtonsoft.Json.JsonWriter.DateFormatString"> <summary> - Get or set how <see cref="T:System.DateTime"/> and <see cref="T:System.DateTimeOffset"/> values are formatting when writing JSON text. + Gets or sets how <see cref="T:System.DateTime"/> and <see cref="T:System.DateTimeOffset"/> values are formatted when writing JSON text. </summary> </member> <member name="P:Newtonsoft.Json.JsonWriter.Culture"> @@ -3716,17 +5204,19 @@ </member> <member name="M:Newtonsoft.Json.JsonWriter.#ctor"> <summary> - Creates an instance of the <c>JsonWriter</c> class. + Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonWriter"/> class. </summary> </member> <member name="M:Newtonsoft.Json.JsonWriter.Flush"> <summary> - 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. </summary> </member> <member name="M:Newtonsoft.Json.JsonWriter.Close"> <summary> - Closes this stream and the underlying stream. + Closes this writer. + If <see cref="P:Newtonsoft.Json.JsonWriter.CloseOutput"/> is set to <c>true</c>, the destination is also closed. + If <see cref="P:Newtonsoft.Json.JsonWriter.AutoCompleteOnClose"/> is set to <c>true</c>, the JSON is auto-completed. </summary> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteStartObject"> @@ -3762,13 +5252,13 @@ </member> <member name="M:Newtonsoft.Json.JsonWriter.WritePropertyName(System.String)"> <summary> - 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. </summary> <param name="name">The name of the property.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WritePropertyName(System.String,System.Boolean)"> <summary> - 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. </summary> <param name="name">The name of the property.</param> <param name="escape">A flag to indicate whether the text should be escaped when it is written as a JSON property name.</param> @@ -3799,7 +5289,8 @@ <param name="value"> The value to write. A value is only required for tokens that have an associated value, e.g. the <see cref="T:System.String"/> property name for <see cref="F:Newtonsoft.Json.JsonToken.PropertyName"/>. - A null value can be passed to the method for token's that don't have a value, e.g. <see cref="F:Newtonsoft.Json.JsonToken.StartObject"/>.</param> + <c>null</c> can be passed to the method for tokens that don't have a value, e.g. <see cref="F:Newtonsoft.Json.JsonToken.StartObject"/>. + </param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteToken(Newtonsoft.Json.JsonToken)"> <summary> @@ -3960,105 +5451,105 @@ </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Int32})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.UInt32})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Int64})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.UInt64})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Single})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Double})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Boolean})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Int16})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.UInt16})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Char})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Char"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Char"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Byte})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.SByte})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Decimal})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.DateTime})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.DateTimeOffset})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.Guid})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Nullable{System.TimeSpan})"> <summary> - Writes a <see cref="T:System.Nullable`1"/> value. + Writes a <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/> value. </summary> - <param name="value">The <see cref="T:System.Nullable`1"/> value to write.</param> + <param name="value">The <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/> value to write.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteValue(System.Byte[])"> <summary> @@ -4081,32 +5572,32 @@ </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteComment(System.String)"> <summary> - Writes out a comment <code>/*...*/</code> containing the specified text. + Writes a comment <c>/*...*/</c> containing the specified text. </summary> <param name="text">Text to place inside the comment.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.WriteWhitespace(System.String)"> <summary> - Writes out the given white space. + Writes the given white space. </summary> <param name="ws">The string of white space characters.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.Dispose(System.Boolean)"> <summary> - Releases unmanaged and - optionally - managed resources + Releases unmanaged and - optionally - managed resources. </summary> <param name="disposing"><c>true</c> to release both managed and unmanaged resources; <c>false</c> to release only unmanaged resources.</param> </member> <member name="M:Newtonsoft.Json.JsonWriter.SetWriteState(Newtonsoft.Json.JsonToken,System.Object)"> <summary> - Sets the state of the JsonWriter, + Sets the state of the <see cref="T:Newtonsoft.Json.JsonWriter"/>. </summary> - <param name="token">The JsonToken being written.</param> + <param name="token">The <see cref="T:Newtonsoft.Json.JsonToken"/> being written.</param> <param name="value">The value being written.</param> </member> <member name="T:Newtonsoft.Json.JsonWriterException"> <summary> - The exception thrown when an error occurs while reading JSON text. + The exception thrown when an error occurs while writing JSON text. </summary> </member> <member name="P:Newtonsoft.Json.JsonWriterException.Path"> @@ -4133,7 +5624,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. </summary> <param name="message">The error message that explains the reason for the exception.</param> - <param name="innerException">The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.</param> + <param name="innerException">The exception that is the cause of the current exception, or <c>null</c> if no inner exception is specified.</param> </member> <member name="M:Newtonsoft.Json.JsonWriterException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)"> <summary> @@ -4141,8 +5632,17 @@ </summary> <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"/> that holds the serialized object data about the exception being thrown.</param> <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext"/> that contains contextual information about the source or destination.</param> - <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is null. </exception> - <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is null or <see cref="P:System.Exception.HResult"/> is zero (0). </exception> + <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is <c>null</c>.</exception> + <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is <c>null</c> or <see cref="P:System.Exception.HResult"/> is zero (0).</exception> + </member> + <member name="M:Newtonsoft.Json.JsonWriterException.#ctor(System.String,System.String,System.Exception)"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.JsonWriterException"/> class + with a specified error message, JSON path and a reference to the inner exception that is the cause of this exception. + </summary> + <param name="message">The error message that explains the reason for the exception.</param> + <param name="path">The path to the JSON where the error occurred.</param> + <param name="innerException">The exception that is the cause of the current exception, or <c>null</c> if no inner exception is specified.</param> </member> <member name="T:Newtonsoft.Json.Linq.CommentHandling"> <summary> @@ -4157,21 +5657,6 @@ <member name="F:Newtonsoft.Json.Linq.CommentHandling.Load"> <summary> Load comments as a <see cref="T:Newtonsoft.Json.Linq.JValue"/> with type <see cref="F:Newtonsoft.Json.Linq.JTokenType.Comment"/>. - </summary> - </member> - <member name="T:Newtonsoft.Json.Linq.LineInfoHandling"> - <summary> - Specifies how line information is handled when loading JSON. - </summary> - </member> - <member name="F:Newtonsoft.Json.Linq.LineInfoHandling.Ignore"> - <summary> - Ignore line information. - </summary> - </member> - <member name="F:Newtonsoft.Json.Linq.LineInfoHandling.Load"> - <summary> - Load line information. </summary> </member> <member name="T:Newtonsoft.Json.Linq.Extensions"> @@ -4303,11 +5788,11 @@ <summary> Represents a collection of <see cref="T:Newtonsoft.Json.Linq.JToken"/> objects. </summary> - <typeparam name="T">The type of token</typeparam> + <typeparam name="T">The type of token.</typeparam> </member> <member name="P:Newtonsoft.Json.Linq.IJEnumerable`1.Item(System.Object)"> <summary> - Gets the <see cref="T:Newtonsoft.Json.Linq.IJEnumerable`1"/> with the specified key. + Gets the <see cref="T:Newtonsoft.Json.Linq.IJEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> with the specified key. </summary> <value></value> </member> @@ -4318,6 +5803,34 @@ <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateParseArray" title="Parsing a JSON Array from Text" /> </example> + </member> + <member name="M:Newtonsoft.Json.Linq.JArray.WriteToAsync(Newtonsoft.Json.JsonWriter,System.Threading.CancellationToken,Newtonsoft.Json.JsonConverter[])"> + <summary> + Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/> asynchronously. + </summary> + <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous write operation.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JArray.LoadAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JArray"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JArray"/>. + If this is <c>null</c>, default load settings will be used.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> representing the asynchronous load. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> property contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JArray.LoadAsync(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JArray"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> + <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. + If this is <c>null</c>, default load settings will be used.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> representing the asynchronous load. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> property contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="P:Newtonsoft.Json.Linq.JArray.ChildrenTokens"> <summary> @@ -4367,7 +5880,7 @@ </summary> <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JArray"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JArray.Parse(System.String)"> @@ -4386,7 +5899,7 @@ </summary> <param name="json">A <see cref="T:System.String"/> that contains JSON.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JArray"/> populated from the string that contains JSON.</returns> <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateParseArray" title="Parsing a JSON Array from Text" /> @@ -4397,7 +5910,7 @@ Creates a <see cref="T:Newtonsoft.Json.Linq.JArray"/> from an object. </summary> <param name="o">The object that will be used to create <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JArray"/> with the values of the specified object</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JArray"/> with the values of the specified object.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JArray.FromObject(System.Object,Newtonsoft.Json.JsonSerializer)"> <summary> @@ -4405,7 +5918,7 @@ </summary> <param name="o">The object that will be used to create <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> <param name="jsonSerializer">The <see cref="T:Newtonsoft.Json.JsonSerializer"/> that will be used to read the object.</param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JArray"/> with the values of the specified object</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JArray"/> with the values of the specified object.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JArray.WriteTo(Newtonsoft.Json.JsonWriter,Newtonsoft.Json.JsonConverter[])"> <summary> @@ -4428,89 +5941,117 @@ </member> <member name="M:Newtonsoft.Json.Linq.JArray.IndexOf(Newtonsoft.Json.Linq.JToken)"> <summary> - Determines the index of a specific item in the <see cref="T:System.Collections.Generic.IList`1"/>. + Determines the index of a specific item in the <see cref="T:Newtonsoft.Json.Linq.JArray"/>. </summary> - <param name="item">The object to locate in the <see cref="T:System.Collections.Generic.IList`1"/>.</param> + <param name="item">The object to locate in the <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> <returns> The index of <paramref name="item"/> if found in the list; otherwise, -1. </returns> </member> <member name="M:Newtonsoft.Json.Linq.JArray.Insert(System.Int32,Newtonsoft.Json.Linq.JToken)"> <summary> - Inserts an item to the <see cref="T:System.Collections.Generic.IList`1"/> at the specified index. + Inserts an item to the <see cref="T:Newtonsoft.Json.Linq.JArray"/> at the specified index. </summary> <param name="index">The zero-based index at which <paramref name="item"/> should be inserted.</param> - <param name="item">The object to insert into the <see cref="T:System.Collections.Generic.IList`1"/>.</param> + <param name="item">The object to insert into the <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> <exception cref="T:System.ArgumentOutOfRangeException"> - <paramref name="index"/> is not a valid index in the <see cref="T:System.Collections.Generic.IList`1"/>.</exception> - <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IList`1"/> is read-only.</exception> + <paramref name="index"/> is not a valid index in the <see cref="T:Newtonsoft.Json.Linq.JArray"/>. + </exception> </member> <member name="M:Newtonsoft.Json.Linq.JArray.RemoveAt(System.Int32)"> <summary> - Removes the <see cref="T:System.Collections.Generic.IList`1"/> item at the specified index. + Removes the <see cref="T:Newtonsoft.Json.Linq.JArray"/> item at the specified index. </summary> <param name="index">The zero-based index of the item to remove.</param> <exception cref="T:System.ArgumentOutOfRangeException"> - <paramref name="index"/> is not a valid index in the <see cref="T:System.Collections.Generic.IList`1"/>.</exception> - <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.IList`1"/> is read-only.</exception> + <paramref name="index"/> is not a valid index in the <see cref="T:Newtonsoft.Json.Linq.JArray"/>. + </exception> </member> <member name="M:Newtonsoft.Json.Linq.JArray.GetEnumerator"> <summary> Returns an enumerator that iterates through the collection. </summary> <returns> - A <see cref="T:System.Collections.Generic.IEnumerator`1" /> that can be used to iterate through the collection. + A <see cref="T:System.Collections.Generic.IEnumerator`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> that can be used to iterate through the collection. </returns> </member> <member name="M:Newtonsoft.Json.Linq.JArray.Add(Newtonsoft.Json.Linq.JToken)"> <summary> - Adds an item to the <see cref="T:System.Collections.Generic.ICollection`1"/>. + Adds an item to the <see cref="T:Newtonsoft.Json.Linq.JArray"/>. </summary> - <param name="item">The object to add to the <see cref="T:System.Collections.Generic.ICollection`1"/>.</param> - <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only.</exception> + <param name="item">The object to add to the <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> </member> <member name="M:Newtonsoft.Json.Linq.JArray.Clear"> <summary> - Removes all items from the <see cref="T:System.Collections.Generic.ICollection`1"/>. + Removes all items from the <see cref="T:Newtonsoft.Json.Linq.JArray"/>. </summary> - <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only. </exception> </member> <member name="M:Newtonsoft.Json.Linq.JArray.Contains(Newtonsoft.Json.Linq.JToken)"> <summary> - Determines whether the <see cref="T:System.Collections.Generic.ICollection`1"/> contains a specific value. + Determines whether the <see cref="T:Newtonsoft.Json.Linq.JArray"/> contains a specific value. </summary> - <param name="item">The object to locate in the <see cref="T:System.Collections.Generic.ICollection`1"/>.</param> + <param name="item">The object to locate in the <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> <returns> - true if <paramref name="item"/> is found in the <see cref="T:System.Collections.Generic.ICollection`1"/>; otherwise, false. + <c>true</c> if <paramref name="item"/> is found in the <see cref="T:Newtonsoft.Json.Linq.JArray"/>; otherwise, <c>false</c>. </returns> </member> <member name="M:Newtonsoft.Json.Linq.JArray.CopyTo(Newtonsoft.Json.Linq.JToken[],System.Int32)"> <summary> - Copies to. + Copies the elements of the <see cref="T:Newtonsoft.Json.Linq.JArray"/> to an array, starting at a particular array index. </summary> <param name="array">The array.</param> <param name="arrayIndex">Index of the array.</param> </member> <member name="P:Newtonsoft.Json.Linq.JArray.IsReadOnly"> <summary> - Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only. + Gets a value indicating whether the <see cref="T:Newtonsoft.Json.Linq.JArray"/> is read-only. </summary> - <returns>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</returns> + <returns><c>true</c> if the <see cref="T:Newtonsoft.Json.Linq.JArray"/> is read-only; otherwise, <c>false</c>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JArray.Remove(Newtonsoft.Json.Linq.JToken)"> <summary> - Removes the first occurrence of a specific object from the <see cref="T:System.Collections.Generic.ICollection`1"/>. + Removes the first occurrence of a specific object from the <see cref="T:Newtonsoft.Json.Linq.JArray"/>. </summary> - <param name="item">The object to remove from the <see cref="T:System.Collections.Generic.ICollection`1"/>.</param> + <param name="item">The object to remove from the <see cref="T:Newtonsoft.Json.Linq.JArray"/>.</param> <returns> - true if <paramref name="item"/> was successfully removed from the <see cref="T:System.Collections.Generic.ICollection`1"/>; otherwise, false. This method also returns false if <paramref name="item"/> is not found in the original <see cref="T:System.Collections.Generic.ICollection`1"/>. + <c>true</c> if <paramref name="item"/> was successfully removed from the <see cref="T:Newtonsoft.Json.Linq.JArray"/>; otherwise, <c>false</c>. This method also returns <c>false</c> if <paramref name="item"/> is not found in the original <see cref="T:Newtonsoft.Json.Linq.JArray"/>. </returns> - <exception cref="T:System.NotSupportedException">The <see cref="T:System.Collections.Generic.ICollection`1"/> is read-only.</exception> </member> <member name="T:Newtonsoft.Json.Linq.JConstructor"> <summary> Represents a JSON constructor. </summary> + </member> + <member name="M:Newtonsoft.Json.Linq.JConstructor.WriteToAsync(Newtonsoft.Json.JsonWriter,System.Threading.CancellationToken,Newtonsoft.Json.JsonConverter[])"> + <summary> + Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/> asynchronously. + </summary> + <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous write operation.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JConstructor.LoadAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JConstructor"/>.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous load. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JConstructor.LoadAsync(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JConstructor"/>.</param> + <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. + If this is <c>null</c>, default load settings will be used.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous load. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="P:Newtonsoft.Json.Linq.JConstructor.ChildrenTokens"> <summary> @@ -4576,18 +6117,18 @@ </member> <member name="M:Newtonsoft.Json.Linq.JConstructor.Load(Newtonsoft.Json.JsonReader)"> <summary> - Loads an <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + Loads a <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JConstructor"/>.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JConstructor.Load(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings)"> <summary> - Loads an <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + Loads a <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JConstructor"/>.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JConstructor"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="T:Newtonsoft.Json.Linq.JContainer"> @@ -4679,13 +6220,13 @@ <summary> Returns a collection of the descendant tokens for this token in document order. </summary> - <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> containing the descendant tokens of the <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</returns> + <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> containing the descendant tokens of the <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JContainer.DescendantsAndSelf"> <summary> Returns a collection of the tokens that contain this token, and all descendant tokens of this token, in document order. </summary> - <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> containing this token, and all the descendant tokens of the <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</returns> + <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> containing this token, and all the descendant tokens of the <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JContainer.Add(System.Object)"> <summary> @@ -4701,13 +6242,13 @@ </member> <member name="M:Newtonsoft.Json.Linq.JContainer.CreateWriter"> <summary> - Creates an <see cref="T:Newtonsoft.Json.JsonWriter"/> that can be used to add tokens to the <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Creates a <see cref="T:Newtonsoft.Json.JsonWriter"/> that can be used to add tokens to the <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> - <returns>An <see cref="T:Newtonsoft.Json.JsonWriter"/> that is ready to have content written to it.</returns> + <returns>A <see cref="T:Newtonsoft.Json.JsonWriter"/> that is ready to have content written to it.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JContainer.ReplaceAll(System.Object)"> <summary> - Replaces the children nodes of this token with the specified content. + Replaces the child nodes of this token with the specified content. </summary> <param name="content">The content.</param> </member> @@ -4733,13 +6274,13 @@ <summary> Gets the count of child JSON tokens. </summary> - <value>The count of child JSON tokens</value> + <value>The count of child JSON tokens.</value> </member> <member name="T:Newtonsoft.Json.Linq.JEnumerable`1"> <summary> Represents a collection of <see cref="T:Newtonsoft.Json.Linq.JToken"/> objects. </summary> - <typeparam name="T">The type of token</typeparam> + <typeparam name="T">The type of token.</typeparam> </member> <member name="F:Newtonsoft.Json.Linq.JEnumerable`1.Empty"> <summary> @@ -4754,23 +6295,15 @@ </member> <member name="M:Newtonsoft.Json.Linq.JEnumerable`1.GetEnumerator"> <summary> - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. </summary> <returns> A <see cref="T:System.Collections.Generic.IEnumerator`1"/> that can be used to iterate through the collection. </returns> </member> - <member name="M:Newtonsoft.Json.Linq.JEnumerable`1.System#Collections#IEnumerable#GetEnumerator"> - <summary> - Returns an enumerator that iterates through a collection. - </summary> - <returns> - An <see cref="T:System.Collections.IEnumerator"/> object that can be used to iterate through the collection. - </returns> - </member> <member name="P:Newtonsoft.Json.Linq.JEnumerable`1.Item(System.Object)"> <summary> - Gets the <see cref="T:Newtonsoft.Json.Linq.IJEnumerable`1"/> with the specified key. + Gets the <see cref="T:Newtonsoft.Json.Linq.IJEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> with the specified key. </summary> <value></value> </member> @@ -4807,6 +6340,37 @@ <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateParse" title="Parsing a JSON Object from Text" /> </example> + </member> + <member name="M:Newtonsoft.Json.Linq.JObject.WriteToAsync(Newtonsoft.Json.JsonWriter,System.Threading.CancellationToken,Newtonsoft.Json.JsonConverter[])"> + <summary> + Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/> asynchronously. + </summary> + <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous write operation.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JObject.LoadAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JObject"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JObject"/>.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous load. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JObject"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JObject.LoadAsync(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JObject"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JObject"/>.</param> + <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. + If this is <c>null</c>, default load settings will be used.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous load. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JObject"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="P:Newtonsoft.Json.Linq.JObject.ChildrenTokens"> <summary> @@ -4855,22 +6419,22 @@ </member> <member name="M:Newtonsoft.Json.Linq.JObject.Properties"> <summary> - Gets an <see cref="T:System.Collections.Generic.IEnumerable`1"/> of this object's properties. + Gets an <see cref="T:System.Collections.Generic.IEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JProperty"/> of this object's properties. </summary> - <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> of this object's properties.</returns> + <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JProperty"/> of this object's properties.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JObject.Property(System.String)"> <summary> Gets a <see cref="T:Newtonsoft.Json.Linq.JProperty"/> the specified name. </summary> <param name="name">The property name.</param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JProperty"/> with the specified name or null.</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JProperty"/> with the specified name or <c>null</c>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JObject.PropertyValues"> <summary> - Gets an <see cref="T:Newtonsoft.Json.Linq.JEnumerable`1"/> of this object's property values. + Gets a <see cref="T:Newtonsoft.Json.Linq.JEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> of this object's property values. </summary> - <returns>An <see cref="T:Newtonsoft.Json.Linq.JEnumerable`1"/> of this object's property values.</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> of this object's property values.</returns> </member> <member name="P:Newtonsoft.Json.Linq.JObject.Item(System.Object)"> <summary> @@ -4886,19 +6450,25 @@ </member> <member name="M:Newtonsoft.Json.Linq.JObject.Load(Newtonsoft.Json.JsonReader)"> <summary> - Loads an <see cref="T:Newtonsoft.Json.Linq.JObject"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + Loads a <see cref="T:Newtonsoft.Json.Linq.JObject"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JObject"/>.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> + <exception cref="T:Newtonsoft.Json.JsonReaderException"> + <paramref name="reader"/> is not valid JSON. + </exception> </member> <member name="M:Newtonsoft.Json.Linq.JObject.Load(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings)"> <summary> - Loads an <see cref="T:Newtonsoft.Json.Linq.JObject"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + Loads a <see cref="T:Newtonsoft.Json.Linq.JObject"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JObject"/>.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> + <exception cref="T:Newtonsoft.Json.JsonReaderException"> + <paramref name="reader"/> is not valid JSON. + </exception> </member> <member name="M:Newtonsoft.Json.Linq.JObject.Parse(System.String)"> <summary> @@ -4906,6 +6476,9 @@ </summary> <param name="json">A <see cref="T:System.String"/> that contains JSON.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> populated from the string that contains JSON.</returns> + <exception cref="T:Newtonsoft.Json.JsonReaderException"> + <paramref name="json"/> is not valid JSON. + </exception> <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateParse" title="Parsing a JSON Object from Text" /> </example> @@ -4916,8 +6489,11 @@ </summary> <param name="json">A <see cref="T:System.String"/> that contains JSON.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> populated from the string that contains JSON.</returns> + <exception cref="T:Newtonsoft.Json.JsonReaderException"> + <paramref name="json"/> is not valid JSON. + </exception> <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\LinqToJsonTests.cs" region="LinqToJsonCreateParse" title="Parsing a JSON Object from Text" /> </example> @@ -4927,7 +6503,7 @@ Creates a <see cref="T:Newtonsoft.Json.Linq.JObject"/> from an object. </summary> <param name="o">The object that will be used to create <see cref="T:Newtonsoft.Json.Linq.JObject"/>.</param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> with the values of the specified object</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> with the values of the specified object.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JObject.FromObject(System.Object,Newtonsoft.Json.JsonSerializer)"> <summary> @@ -4935,7 +6511,7 @@ </summary> <param name="o">The object that will be used to create <see cref="T:Newtonsoft.Json.Linq.JObject"/>.</param> <param name="jsonSerializer">The <see cref="T:Newtonsoft.Json.JsonSerializer"/> that will be used to read the object.</param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> with the values of the specified object</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JObject"/> with the values of the specified object.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JObject.WriteTo(Newtonsoft.Json.JsonWriter,Newtonsoft.Json.JsonConverter[])"> <summary> @@ -4979,6 +6555,13 @@ <param name="propertyName">Name of the property.</param> <param name="value">The value.</param> </member> + <member name="M:Newtonsoft.Json.Linq.JObject.ContainsKey(System.String)"> + <summary> + Determines whether the JSON object has the specified property name. + </summary> + <param name="propertyName">Name of the property.</param> + <returns><c>true</c> if the JSON object has the specified property name; otherwise, <c>false</c>.</returns> + </member> <member name="M:Newtonsoft.Json.Linq.JObject.Remove(System.String)"> <summary> Removes the property with the specified name. @@ -4988,7 +6571,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JObject.TryGetValue(System.String,Newtonsoft.Json.Linq.JToken@)"> <summary> - Tries the get value. + Tries to get the <see cref="T:Newtonsoft.Json.Linq.JToken"/> with the specified property name. </summary> <param name="propertyName">Name of the property.</param> <param name="value">The value.</param> @@ -4996,7 +6579,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JObject.GetEnumerator"> <summary> - Returns an enumerator that iterates through the collection. + Returns an enumerator that can be used to iterate through the collection. </summary> <returns> A <see cref="T:System.Collections.Generic.IEnumerator`1"/> that can be used to iterate through the collection. @@ -5014,106 +6597,6 @@ </summary> <param name="propertyName">Name of the property.</param> </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetProperties"> - <summary> - Returns the properties for this instance of a component. - </summary> - <returns> - A <see cref="T:System.ComponentModel.PropertyDescriptorCollection"/> that represents the properties for this component instance. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetProperties(System.Attribute[])"> - <summary> - Returns the properties for this instance of a component using the attribute array as a filter. - </summary> - <param name="attributes">An array of type <see cref="T:System.Attribute"/> that is used as a filter.</param> - <returns> - A <see cref="T:System.ComponentModel.PropertyDescriptorCollection"/> that represents the filtered properties for this component instance. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetAttributes"> - <summary> - Returns a collection of custom attributes for this instance of a component. - </summary> - <returns> - An <see cref="T:System.ComponentModel.AttributeCollection"/> containing the attributes for this object. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetClassName"> - <summary> - Returns the class name of this instance of a component. - </summary> - <returns> - The class name of the object, or null if the class does not have a name. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetComponentName"> - <summary> - Returns the name of this instance of a component. - </summary> - <returns> - The name of the object, or null if the object does not have a name. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetConverter"> - <summary> - Returns a type converter for this instance of a component. - </summary> - <returns> - A <see cref="T:System.ComponentModel.TypeConverter"/> that is the converter for this object, or null if there is no <see cref="T:System.ComponentModel.TypeConverter"/> for this object. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetDefaultEvent"> - <summary> - Returns the default event for this instance of a component. - </summary> - <returns> - An <see cref="T:System.ComponentModel.EventDescriptor"/> that represents the default event for this object, or null if this object does not have events. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetDefaultProperty"> - <summary> - Returns the default property for this instance of a component. - </summary> - <returns> - A <see cref="T:System.ComponentModel.PropertyDescriptor"/> that represents the default property for this object, or null if this object does not have properties. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetEditor(System.Type)"> - <summary> - Returns an editor of the specified type for this instance of a component. - </summary> - <param name="editorBaseType">A <see cref="T:System.Type"/> that represents the editor for this object.</param> - <returns> - An <see cref="T:System.Object"/> of the specified type that is the editor for this object, or null if the editor cannot be found. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetEvents(System.Attribute[])"> - <summary> - Returns the events for this instance of a component using the specified attribute array as a filter. - </summary> - <param name="attributes">An array of type <see cref="T:System.Attribute"/> that is used as a filter.</param> - <returns> - An <see cref="T:System.ComponentModel.EventDescriptorCollection"/> that represents the filtered events for this component instance. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetEvents"> - <summary> - Returns the events for this instance of a component. - </summary> - <returns> - An <see cref="T:System.ComponentModel.EventDescriptorCollection"/> that represents the events for this component instance. - </returns> - </member> - <member name="M:Newtonsoft.Json.Linq.JObject.System#ComponentModel#ICustomTypeDescriptor#GetPropertyOwner(System.ComponentModel.PropertyDescriptor)"> - <summary> - Returns an object that contains the property described by the specified property descriptor. - </summary> - <param name="pd">A <see cref="T:System.ComponentModel.PropertyDescriptor"/> that represents the property whose owner is to be found.</param> - <returns> - An <see cref="T:System.Object"/> that represents the owner of the specified property. - </returns> - </member> <member name="M:Newtonsoft.Json.Linq.JObject.GetMetaObject(System.Linq.Expressions.Expression)"> <summary> Returns the <see cref="T:System.Dynamic.DynamicMetaObject"/> responsible for binding operations performed on this object. @@ -5123,27 +6606,39 @@ The <see cref="T:System.Dynamic.DynamicMetaObject"/> to bind this object. </returns> </member> - <member name="T:Newtonsoft.Json.Linq.JsonMergeSettings"> - <summary> - Specifies the settings used when merging JSON. - </summary> - </member> - <member name="P:Newtonsoft.Json.Linq.JsonMergeSettings.MergeArrayHandling"> - <summary> - Gets or sets the method used when merging JSON arrays. - </summary> - <value>The method used when merging JSON arrays.</value> - </member> - <member name="P:Newtonsoft.Json.Linq.JsonMergeSettings.MergeNullValueHandling"> - <summary> - Gets or sets how how null value properties are merged. - </summary> - <value>How null value properties are merged.</value> - </member> <member name="T:Newtonsoft.Json.Linq.JProperty"> <summary> Represents a JSON property. </summary> + </member> + <member name="M:Newtonsoft.Json.Linq.JProperty.WriteToAsync(Newtonsoft.Json.JsonWriter,System.Threading.CancellationToken,Newtonsoft.Json.JsonConverter[])"> + <summary> + Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/> asynchronously. + </summary> + <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous write operation.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JProperty.LoadAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JProperty"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JProperty"/>.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> representing the asynchronous creation. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JProperty"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JProperty.LoadAsync(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings,System.Threading.CancellationToken)"> + <summary> + Asynchronously loads a <see cref="T:Newtonsoft.Json.Linq.JProperty"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JProperty"/>.</param> + <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. + If this is <c>null</c>, default load settings will be used.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> representing the asynchronous creation. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JProperty"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="P:Newtonsoft.Json.Linq.JProperty.ChildrenTokens"> <summary> @@ -5198,18 +6693,18 @@ </member> <member name="M:Newtonsoft.Json.Linq.JProperty.Load(Newtonsoft.Json.JsonReader)"> <summary> - Loads an <see cref="T:Newtonsoft.Json.Linq.JProperty"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + Loads a <see cref="T:Newtonsoft.Json.Linq.JProperty"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JProperty"/>.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JProperty"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JProperty.Load(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings)"> <summary> - Loads an <see cref="T:Newtonsoft.Json.Linq.JProperty"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + Loads a <see cref="T:Newtonsoft.Json.Linq.JProperty"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> that will be read for the content of the <see cref="T:Newtonsoft.Json.Linq.JProperty"/>.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JProperty"/> that contains the JSON that was read from the specified <see cref="T:Newtonsoft.Json.JsonReader"/>.</returns> </member> <member name="T:Newtonsoft.Json.Linq.JPropertyDescriptor"> @@ -5239,23 +6734,20 @@ <returns> The value of a property for a given component. </returns> - <param name="component">The component with the property for which to retrieve the value. - </param> + <param name="component">The component with the property for which to retrieve the value.</param> </member> <member name="M:Newtonsoft.Json.Linq.JPropertyDescriptor.ResetValue(System.Object)"> <summary> When overridden in a derived class, resets the value for this property of the component to the default value. </summary> - <param name="component">The component with the property value that is to be reset to the default value. - </param> + <param name="component">The component with the property value that is to be reset to the default value.</param> </member> <member name="M:Newtonsoft.Json.Linq.JPropertyDescriptor.SetValue(System.Object,System.Object)"> <summary> When overridden in a derived class, sets the value of the component to a different value. </summary> - <param name="component">The component with the property value that is to be set. - </param><param name="value">The new value. - </param> + <param name="component">The component with the property value that is to be set.</param> + <param name="value">The new value.</param> </member> <member name="M:Newtonsoft.Json.Linq.JPropertyDescriptor.ShouldSerializeValue(System.Object)"> <summary> @@ -5271,7 +6763,10 @@ When overridden in a derived class, gets the type of the component this property is bound to. </summary> <returns> - A <see cref="T:System.Type"/> that represents the type of component this property is bound to. When the <see cref="M:System.ComponentModel.PropertyDescriptor.GetValue(System.Object)"/> or <see cref="M:System.ComponentModel.PropertyDescriptor.SetValue(System.Object,System.Object)"/> methods are invoked, the object specified might be an instance of this type. + A <see cref="T:System.Type"/> that represents the type of component this property is bound to. + When the <see cref="M:System.ComponentModel.PropertyDescriptor.GetValue(System.Object)"/> or + <see cref="M:System.ComponentModel.PropertyDescriptor.SetValue(System.Object,System.Object)"/> + methods are invoked, the object specified might be an instance of this type. </returns> </member> <member name="P:Newtonsoft.Json.Linq.JPropertyDescriptor.IsReadOnly"> @@ -5304,6 +6799,15 @@ Represents a raw JSON string. </summary> </member> + <member name="M:Newtonsoft.Json.Linq.JRaw.CreateAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously creates an instance of <see cref="T:Newtonsoft.Json.Linq.JRaw"/> with the content of the reader's current token. + </summary> + <param name="reader">The reader.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> representing the asynchronous creation. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns an instance of <see cref="T:Newtonsoft.Json.Linq.JRaw"/> with the content of the reader's current token.</returns> + </member> <member name="M:Newtonsoft.Json.Linq.JRaw.#ctor(Newtonsoft.Json.Linq.JRaw)"> <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Linq.JRaw"/> class from another <see cref="T:Newtonsoft.Json.Linq.JRaw"/> object. @@ -5323,10 +6827,124 @@ <param name="reader">The reader.</param> <returns>An instance of <see cref="T:Newtonsoft.Json.Linq.JRaw"/> with the content of the reader's current token.</returns> </member> + <member name="T:Newtonsoft.Json.Linq.JsonLoadSettings"> + <summary> + Specifies the settings used when loading JSON. + </summary> + </member> + <member name="M:Newtonsoft.Json.Linq.JsonLoadSettings.#ctor"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> class. + </summary> + </member> + <member name="P:Newtonsoft.Json.Linq.JsonLoadSettings.CommentHandling"> + <summary> + Gets or sets how JSON comments are handled when loading JSON. + </summary> + <value>The JSON comment handling.</value> + </member> + <member name="P:Newtonsoft.Json.Linq.JsonLoadSettings.LineInfoHandling"> + <summary> + Gets or sets how JSON line info is handled when loading JSON. + </summary> + <value>The JSON line info handling.</value> + </member> + <member name="T:Newtonsoft.Json.Linq.JsonMergeSettings"> + <summary> + Specifies the settings used when merging JSON. + </summary> + </member> + <member name="P:Newtonsoft.Json.Linq.JsonMergeSettings.MergeArrayHandling"> + <summary> + Gets or sets the method used when merging JSON arrays. + </summary> + <value>The method used when merging JSON arrays.</value> + </member> + <member name="P:Newtonsoft.Json.Linq.JsonMergeSettings.MergeNullValueHandling"> + <summary> + Gets or sets how null value properties are merged. + </summary> + <value>How null value properties are merged.</value> + </member> <member name="T:Newtonsoft.Json.Linq.JToken"> <summary> Represents an abstract JSON token. </summary> + </member> + <member name="M:Newtonsoft.Json.Linq.JToken.WriteToAsync(Newtonsoft.Json.JsonWriter,System.Threading.CancellationToken,Newtonsoft.Json.JsonConverter[])"> + <summary> + Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/> asynchronously. + </summary> + <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous write operation.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JToken.WriteToAsync(Newtonsoft.Json.JsonWriter,Newtonsoft.Json.JsonConverter[])"> + <summary> + Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/> asynchronously. + </summary> + <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous write operation.</returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JToken.ReadFromAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">An <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous creation. The + <see cref="P:System.Threading.Tasks.Task`1.Result"/> property returns a <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. + </returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JToken.ReadFromAsync(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings,System.Threading.CancellationToken)"> + <summary> + Asynchronously creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">An <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> + <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. + If this is <c>null</c>, default load settings will be used.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous creation. The + <see cref="P:System.Threading.Tasks.Task`1.Result"/> property returns a <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. + </returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JToken.LoadAsync(Newtonsoft.Json.JsonReader,System.Threading.CancellationToken)"> + <summary> + Asynchronously creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous creation. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. + </returns> + </member> + <member name="M:Newtonsoft.Json.Linq.JToken.LoadAsync(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings,System.Threading.CancellationToken)"> + <summary> + Asynchronously creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. + </summary> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> + <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. + If this is <c>null</c>, default load settings will be used.</param> + <param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None"/>.</param> + <returns> + A <see cref="T:System.Threading.Tasks.Task`1"/> that represents the asynchronous creation. The <see cref="P:System.Threading.Tasks.Task`1.Result"/> + property returns a <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. + </returns> </member> <member name="P:Newtonsoft.Json.Linq.JToken.EqualityComparer"> <summary> @@ -5497,8 +7115,8 @@ <summary> Returns the JSON for this token using the given formatting and converters. </summary> - <param name="formatting">Indicates how the output is formatted.</param> - <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <param name="formatting">Indicates how the output should be formatted.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/>s which will be used when writing the token.</param> <returns>The JSON for this token using the given formatting and converters.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Boolean"> @@ -5517,49 +7135,49 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Boolean}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Int64"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Int64"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.DateTime}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.DateTimeOffset}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Decimal}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Double}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Char}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Char"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> @@ -5608,56 +7226,56 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Int32}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> . </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Int16}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.UInt16}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Byte}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.SByte}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.DateTime"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.DateTime"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Int64}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Single}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> @@ -5671,14 +7289,14 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.UInt32}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.UInt64}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> @@ -5734,7 +7352,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.Guid}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Guid"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> . </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> @@ -5748,7 +7366,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Explicit(Newtonsoft.Json.Linq.JToken)~System.Nullable{System.TimeSpan}"> <summary> - Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.TimeSpan"/>. + Performs an explicit conversion from <see cref="T:Newtonsoft.Json.Linq.JToken"/> to <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/>. </summary> <param name="value">The value.</param> <returns>The result of the conversion.</returns> @@ -5783,7 +7401,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Byte})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Byte"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> @@ -5797,49 +7415,49 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.SByte})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.SByte"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Boolean})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Boolean"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Int64)~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.DateTime})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTime"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.DateTimeOffset})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.DateTimeOffset"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Decimal})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Decimal"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Double})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Double"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> @@ -5867,7 +7485,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Int32})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int32"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> @@ -5881,14 +7499,14 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Int64})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int64"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Single})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Single"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> @@ -5902,28 +7520,28 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Int16})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Int16"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.UInt16})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt16"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.UInt32})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt32"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.UInt64})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.UInt64"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> @@ -5986,7 +7604,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.TimeSpan})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.TimeSpan"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> @@ -6000,23 +7618,23 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.op_Implicit(System.Nullable{System.Guid})~Newtonsoft.Json.Linq.JToken"> <summary> - Performs an implicit conversion from <see cref="T:System.Nullable`1"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Performs an implicit conversion from <see cref="T:System.Nullable`1"/> of <see cref="T:System.Guid"/> to <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="value">The value to create a <see cref="T:Newtonsoft.Json.Linq.JValue"/> from.</param> <returns>The <see cref="T:Newtonsoft.Json.Linq.JValue"/> initialized with the specified value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.CreateReader"> <summary> - Creates an <see cref="T:Newtonsoft.Json.JsonReader"/> for this token. + Creates a <see cref="T:Newtonsoft.Json.JsonReader"/> for this token. </summary> - <returns>An <see cref="T:Newtonsoft.Json.JsonReader"/> that can be used to read this token and its descendants.</returns> + <returns>A <see cref="T:Newtonsoft.Json.JsonReader"/> that can be used to read this token and its descendants.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.FromObject(System.Object)"> <summary> Creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from an object. </summary> <param name="o">The object that will be used to create <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JToken"/> with the value of the specified object</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JToken"/> with the value of the specified object.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.FromObject(System.Object,Newtonsoft.Json.JsonSerializer)"> <summary> @@ -6024,25 +7642,25 @@ </summary> <param name="o">The object that will be used to create <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> <param name="jsonSerializer">The <see cref="T:Newtonsoft.Json.JsonSerializer"/> that will be used when reading the object.</param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JToken"/> with the value of the specified object</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JToken"/> with the value of the specified object.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.ToObject``1"> <summary> - Creates the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Creates an instance of the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <typeparam name="T">The object type that the token will be deserialized to.</typeparam> <returns>The new object created from the JSON value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.ToObject(System.Type)"> <summary> - Creates the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/>. + Creates an instance of the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <param name="objectType">The object type that the token will be deserialized to.</param> <returns>The new object created from the JSON value.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.ToObject``1(Newtonsoft.Json.JsonSerializer)"> <summary> - Creates the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/> using the specified <see cref="T:Newtonsoft.Json.JsonSerializer"/>. + Creates an instance of the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/> using the specified <see cref="T:Newtonsoft.Json.JsonSerializer"/>. </summary> <typeparam name="T">The object type that the token will be deserialized to.</typeparam> <param name="jsonSerializer">The <see cref="T:Newtonsoft.Json.JsonSerializer"/> that will be used when creating the object.</param> @@ -6050,7 +7668,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JToken.ToObject(System.Type,Newtonsoft.Json.JsonSerializer)"> <summary> - Creates the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/> using the specified <see cref="T:Newtonsoft.Json.JsonSerializer"/>. + Creates an instance of the specified .NET type from the <see cref="T:Newtonsoft.Json.Linq.JToken"/> using the specified <see cref="T:Newtonsoft.Json.JsonSerializer"/>. </summary> <param name="objectType">The object type that the token will be deserialized to.</param> <param name="jsonSerializer">The <see cref="T:Newtonsoft.Json.JsonSerializer"/> that will be used when creating the object.</param> @@ -6060,9 +7678,9 @@ <summary> Creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> - <param name="reader">An <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> <returns> - An <see cref="T:Newtonsoft.Json.Linq.JToken"/> that contains the token and its descendant tokens + A <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. </returns> @@ -6073,9 +7691,9 @@ </summary> <param name="reader">An <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns> - An <see cref="T:Newtonsoft.Json.Linq.JToken"/> that contains the token and its descendant tokens + A <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. </returns> @@ -6093,18 +7711,18 @@ </summary> <param name="json">A <see cref="T:System.String"/> that contains JSON.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns>A <see cref="T:Newtonsoft.Json.Linq.JToken"/> populated from the string that contains JSON.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.Load(Newtonsoft.Json.JsonReader,Newtonsoft.Json.Linq.JsonLoadSettings)"> <summary> Creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> - <param name="reader">An <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> <param name="settings">The <see cref="T:Newtonsoft.Json.Linq.JsonLoadSettings"/> used to load the JSON. - If this is null, default load settings will be used.</param> + If this is <c>null</c>, default load settings will be used.</param> <returns> - An <see cref="T:Newtonsoft.Json.Linq.JToken"/> that contains the token and its descendant tokens + A <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. </returns> @@ -6113,9 +7731,9 @@ <summary> Creates a <see cref="T:Newtonsoft.Json.Linq.JToken"/> from a <see cref="T:Newtonsoft.Json.JsonReader"/>. </summary> - <param name="reader">An <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> + <param name="reader">A <see cref="T:Newtonsoft.Json.JsonReader"/> positioned at the token to read into this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</param> <returns> - An <see cref="T:Newtonsoft.Json.Linq.JToken"/> that contains the token and its descendant tokens + A <see cref="T:Newtonsoft.Json.Linq.JToken"/> 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. </returns> @@ -6127,7 +7745,7 @@ <param name="path"> A <see cref="T:System.String"/> that contains a JPath expression. </param> - <returns>A <see cref="T:Newtonsoft.Json.Linq.JToken"/>, or null.</returns> + <returns>A <see cref="T:Newtonsoft.Json.Linq.JToken"/>, or <c>null</c>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.SelectToken(System.String,System.Boolean)"> <summary> @@ -6146,7 +7764,7 @@ <param name="path"> A <see cref="T:System.String"/> that contains a JPath expression. </param> - <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> that contains the selected elements.</returns> + <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> that contains the selected elements.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.SelectTokens(System.String,System.Boolean)"> <summary> @@ -6156,7 +7774,7 @@ A <see cref="T:System.String"/> that contains a JPath expression. </param> <param name="errorWhenNoMatch">A flag to indicate whether an error should be thrown if no tokens are found when evaluating part of the expression.</param> - <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> that contains the selected elements.</returns> + <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> of <see cref="T:Newtonsoft.Json.Linq.JToken"/> that contains the selected elements.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.GetMetaObject(System.Linq.Expressions.Expression)"> <summary> @@ -6207,7 +7825,7 @@ Gets a collection of annotations of the specified type for this <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <typeparam name="T">The type of the annotations to retrieve.</typeparam> - <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> that contains the annotations for this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</returns> + <returns>An <see cref="T:System.Collections.Generic.IEnumerable`1"/> that contains the annotations for this <see cref="T:Newtonsoft.Json.Linq.JToken"/>.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JToken.Annotations(System.Type)"> <summary> @@ -6249,7 +7867,7 @@ </summary> <param name="obj">The <see cref="T:System.Object"/> for which a hash code is to be returned.</param> <returns>A hash code for the specified object.</returns> - <exception cref="T:System.ArgumentNullException">The type of <paramref name="obj"/> is a reference type and <paramref name="obj"/> is null.</exception> + <exception cref="T:System.ArgumentNullException">The type of <paramref name="obj"/> is a reference type and <paramref name="obj"/> is <c>null</c>.</exception> </member> <member name="T:Newtonsoft.Json.Linq.JTokenReader"> <summary> @@ -6269,7 +7887,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JTokenReader.Read"> <summary> - Reads the next JSON token from the stream. + Reads the next JSON token from the underlying <see cref="T:Newtonsoft.Json.Linq.JToken"/>. </summary> <returns> <c>true</c> if the next token was read successfully; <c>false</c> if there are no more tokens to read. @@ -6387,9 +8005,9 @@ </member> <member name="P:Newtonsoft.Json.Linq.JTokenWriter.Token"> <summary> - Gets the token being writen. + Gets the token being written. </summary> - <value>The token being writen.</value> + <value>The token being written.</value> </member> <member name="M:Newtonsoft.Json.Linq.JTokenWriter.#ctor(Newtonsoft.Json.Linq.JContainer)"> <summary> @@ -6404,13 +8022,17 @@ </member> <member name="M:Newtonsoft.Json.Linq.JTokenWriter.Flush"> <summary> - 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 <see cref="T:Newtonsoft.Json.Linq.JContainer"/>. </summary> </member> <member name="M:Newtonsoft.Json.Linq.JTokenWriter.Close"> <summary> - Closes this stream and the underlying stream. + Closes this writer. + If <see cref="P:Newtonsoft.Json.JsonWriter.AutoCompleteOnClose"/> is set to <c>true</c>, the JSON is auto-completed. </summary> + <remarks> + Setting <see cref="P:Newtonsoft.Json.JsonWriter.CloseOutput"/> to <c>true</c> has no additional effect, since the underlying <see cref="T:Newtonsoft.Json.Linq.JContainer"/> is a type that cannot be closed. + </remarks> </member> <member name="M:Newtonsoft.Json.Linq.JTokenWriter.WriteStartObject"> <summary> @@ -6443,7 +8065,7 @@ <member name="M:Newtonsoft.Json.Linq.JTokenWriter.WriteValue(System.Object)"> <summary> Writes a <see cref="T:System.Object"/> 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. </summary> <param name="value">The <see cref="T:System.Object"/> value to write.</param> </member> @@ -6465,7 +8087,7 @@ </member> <member name="M:Newtonsoft.Json.Linq.JTokenWriter.WriteComment(System.String)"> <summary> - Writes out a comment <code>/*...*/</code> containing the specified text. + Writes a comment <c>/*...*/</c> containing the specified text. </summary> <param name="text">Text to place inside the comment.</param> </member> @@ -6593,6 +8215,15 @@ <summary> Represents a value in JSON (string, integer, date, etc). </summary> + </member> + <member name="M:Newtonsoft.Json.Linq.JValue.WriteToAsync(Newtonsoft.Json.JsonWriter,System.Threading.CancellationToken,Newtonsoft.Json.JsonConverter[])"> + <summary> + Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/> asynchronously. + </summary> + <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> + <param name="cancellationToken">The token to monitor for cancellation requests.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the asynchronous write operation.</returns> </member> <member name="M:Newtonsoft.Json.Linq.JValue.#ctor(Newtonsoft.Json.Linq.JValue)"> <summary> @@ -6735,7 +8366,7 @@ Writes this token to a <see cref="T:Newtonsoft.Json.JsonWriter"/>. </summary> <param name="writer">A <see cref="T:Newtonsoft.Json.JsonWriter"/> into which this method will write.</param> - <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/> which will be used when writing the token.</param> + <param name="converters">A collection of <see cref="T:Newtonsoft.Json.JsonConverter"/>s which will be used when writing the token.</param> </member> <member name="M:Newtonsoft.Json.Linq.JValue.Equals(Newtonsoft.Json.Linq.JValue)"> <summary> @@ -6754,9 +8385,6 @@ <returns> <c>true</c> if the specified <see cref="T:System.Object"/> is equal to the current <see cref="T:System.Object"/>; otherwise, <c>false</c>. </returns> - <exception cref="T:System.NullReferenceException"> - The <paramref name="obj"/> parameter is null. - </exception> </member> <member name="M:Newtonsoft.Json.Linq.JValue.GetHashCode"> <summary> @@ -6828,25 +8456,23 @@ This instance is greater than <paramref name="obj"/>. </returns> <exception cref="T:System.ArgumentException"> - <paramref name="obj"/> is not the same type as this instance. + <paramref name="obj"/> is not of the same type as this instance. </exception> </member> - <member name="T:Newtonsoft.Json.Linq.JsonLoadSettings"> + <member name="T:Newtonsoft.Json.Linq.LineInfoHandling"> <summary> - Specifies the settings used when loading JSON. + Specifies how line information is handled when loading JSON. </summary> </member> - <member name="P:Newtonsoft.Json.Linq.JsonLoadSettings.CommentHandling"> + <member name="F:Newtonsoft.Json.Linq.LineInfoHandling.Ignore"> <summary> - Gets or sets how JSON comments are handled when loading JSON. + Ignore line information. </summary> - <value>The JSON comment handling.</value> </member> - <member name="P:Newtonsoft.Json.Linq.JsonLoadSettings.LineInfoHandling"> + <member name="F:Newtonsoft.Json.Linq.LineInfoHandling.Load"> <summary> - Gets or sets how JSON line info is handled when loading JSON. + Load line information. </summary> - <value>The JSON line info handling.</value> </member> <member name="T:Newtonsoft.Json.Linq.MergeArrayHandling"> <summary> @@ -6901,7 +8527,7 @@ <summary> All public and private fields are serialized. Members can be excluded using <see cref="T:Newtonsoft.Json.JsonIgnoreAttribute"/> or <see cref="T:System.NonSerializedAttribute"/>. This member serialization mode can also be set by marking the class with <see cref="T:System.SerializableAttribute"/> - and setting IgnoreSerializableAttribute on <see cref="T:Newtonsoft.Json.Serialization.DefaultContractResolver"/> to false. + and setting IgnoreSerializableAttribute on <see cref="T:Newtonsoft.Json.Serialization.DefaultContractResolver"/> to <c>false</c>. </summary> </member> <member name="T:Newtonsoft.Json.MetadataPropertyHandling"> @@ -6981,7 +8607,7 @@ <member name="T:Newtonsoft.Json.PreserveReferencesHandling"> <summary> Specifies reference handling options for the <see cref="T:Newtonsoft.Json.JsonSerializer"/>. - 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 <see cref="T:System.Runtime.Serialization.ISerializable"/>. </summary> <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\SerializationTests.cs" region="PreservingObjectReferencesOn" title="Preserve Object References" /> @@ -7145,7 +8771,7 @@ </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.ReadOnly"> <summary> - Gets or sets whether the object is read only. + Gets or sets whether the object is read-only. </summary> </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.Hidden"> @@ -7189,9 +8815,9 @@ </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.DivisibleBy"> <summary> - Gets or sets a number that the value should be divisble by. + Gets or sets a number that the value should be divisible by. </summary> - <value>A number that the value should be divisble by.</value> + <value>A number that the value should be divisible by.</value> </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.Minimum"> <summary> @@ -7207,15 +8833,15 @@ </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.ExclusiveMinimum"> <summary> - 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 <c>minimum</c> attribute (<see cref="P:Newtonsoft.Json.Schema.JsonSchema.Minimum"/>). </summary> - <value>A flag indicating whether the value can not equal the number defined by the "minimum" attribute.</value> + <value>A flag indicating whether the value can not equal the number defined by the <c>minimum</c> attribute (<see cref="P:Newtonsoft.Json.Schema.JsonSchema.Minimum"/>).</value> </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.ExclusiveMaximum"> <summary> - 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 <c>maximum</c> attribute (<see cref="P:Newtonsoft.Json.Schema.JsonSchema.Maximum"/>). </summary> - <value>A flag indicating whether the value can not equal the number defined by the "maximum" attribute.</value> + <value>A flag indicating whether the value can not equal the number defined by the <c>maximum</c> attribute (<see cref="P:Newtonsoft.Json.Schema.JsonSchema.Maximum"/>).</value> </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.MinimumItems"> <summary> @@ -7304,7 +8930,7 @@ <summary> Gets or sets disallowed types. </summary> - <value>The disallow types.</value> + <value>The disallowed types.</value> </member> <member name="P:Newtonsoft.Json.Schema.JsonSchema.Default"> <summary> @@ -7346,18 +8972,18 @@ </member> <member name="M:Newtonsoft.Json.Schema.JsonSchema.Parse(System.String)"> <summary> - Load a <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> from a string that contains schema JSON. + Load a <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> from a string that contains JSON Schema. </summary> - <param name="json">A <see cref="T:System.String"/> that contains JSON.</param> - <returns>A <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> populated from the string that contains JSON.</returns> + <param name="json">A <see cref="T:System.String"/> that contains JSON Schema.</param> + <returns>A <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> populated from the string that contains JSON Schema.</returns> </member> <member name="M:Newtonsoft.Json.Schema.JsonSchema.Parse(System.String,Newtonsoft.Json.Schema.JsonSchemaResolver)"> <summary> - Parses the specified json. + Load a <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> from a string that contains JSON Schema using the specified <see cref="T:Newtonsoft.Json.Schema.JsonSchemaResolver"/>. </summary> - <param name="json">The json.</param> + <param name="json">A <see cref="T:System.String"/> that contains JSON Schema.</param> <param name="resolver">The resolver.</param> - <returns>A <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> populated from the string that contains JSON.</returns> + <returns>A <see cref="T:Newtonsoft.Json.Schema.JsonSchema"/> populated from the string that contains JSON Schema.</returns> </member> <member name="M:Newtonsoft.Json.Schema.JsonSchema.WriteTo(Newtonsoft.Json.JsonWriter)"> <summary> @@ -7426,7 +9052,7 @@ with a specified error message and a reference to the inner exception that is the cause of this exception. </summary> <param name="message">The error message that explains the reason for the exception.</param> - <param name="innerException">The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.</param> + <param name="innerException">The exception that is the cause of the current exception, or <c>null</c> if no inner exception is specified.</param> </member> <member name="M:Newtonsoft.Json.Schema.JsonSchemaException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)"> <summary> @@ -7434,8 +9060,8 @@ </summary> <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo"/> that holds the serialized object data about the exception being thrown.</param> <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext"/> that contains contextual information about the source or destination.</param> - <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is null. </exception> - <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is null or <see cref="P:System.Exception.HResult"/> is zero (0). </exception> + <exception cref="T:System.ArgumentNullException">The <paramref name="info"/> parameter is <c>null</c>.</exception> + <exception cref="T:System.Runtime.Serialization.SerializationException">The class name is <c>null</c> or <see cref="P:System.Exception.HResult"/> is zero (0).</exception> </member> <member name="T:Newtonsoft.Json.Schema.JsonSchemaGenerator"> <summary> @@ -7636,35 +9262,6 @@ </note> </summary> </member> - <member name="T:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy"> - <summary> - A snake case naming strategy. - </summary> - </member> - <member name="M:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy.#ctor(System.Boolean,System.Boolean)"> - <summary> - Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy"/> class. - </summary> - <param name="processDictionaryKeys"> - A flag indicating whether dictionary keys should be processed. - </param> - <param name="overrideSpecifiedNames"> - A flag indicating whether explicitly specified property names should be processed, - e.g. a property name customized with a <see cref="T:Newtonsoft.Json.JsonPropertyAttribute"/>. - </param> - </member> - <member name="M:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy.#ctor"> - <summary> - Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy"/> class. - </summary> - </member> - <member name="M:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy.ResolvePropertyName(System.String)"> - <summary> - Resolves the specified property name. - </summary> - <param name="name">The property name to resolve.</param> - <returns>The resolved property name.</returns> - </member> <member name="T:Newtonsoft.Json.Serialization.CamelCaseNamingStrategy"> <summary> A camel case naming strategy. @@ -7680,6 +9277,21 @@ <param name="overrideSpecifiedNames"> A flag indicating whether explicitly specified property names should be processed, e.g. a property name customized with a <see cref="T:Newtonsoft.Json.JsonPropertyAttribute"/>. + </param> + </member> + <member name="M:Newtonsoft.Json.Serialization.CamelCaseNamingStrategy.#ctor(System.Boolean,System.Boolean,System.Boolean)"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.CamelCaseNamingStrategy"/> class. + </summary> + <param name="processDictionaryKeys"> + A flag indicating whether dictionary keys should be processed. + </param> + <param name="overrideSpecifiedNames"> + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a <see cref="T:Newtonsoft.Json.JsonPropertyAttribute"/>. + </param> + <param name="processExtensionDataNames"> + A flag indicating whether extension data names should be processed. </param> </member> <member name="M:Newtonsoft.Json.Serialization.CamelCaseNamingStrategy.#ctor"> @@ -7704,9 +9316,16 @@ Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.CamelCasePropertyNamesContractResolver"/> class. </summary> </member> + <member name="M:Newtonsoft.Json.Serialization.CamelCasePropertyNamesContractResolver.ResolveContract(System.Type)"> + <summary> + Resolves the contract for a given type. + </summary> + <param name="type">The type to resolve a contract for.</param> + <returns>The contract for a given type.</returns> + </member> <member name="T:Newtonsoft.Json.Serialization.DefaultContractResolver"> <summary> - Used by <see cref="T:Newtonsoft.Json.JsonSerializer"/> to resolves a <see cref="T:Newtonsoft.Json.Serialization.JsonContract"/> for a given <see cref="T:System.Type"/>. + Used by <see cref="T:Newtonsoft.Json.JsonSerializer"/> to resolve a <see cref="T:Newtonsoft.Json.Serialization.JsonContract"/> for a given <see cref="T:System.Type"/>. </summary> </member> <member name="P:Newtonsoft.Json.Serialization.DefaultContractResolver.DynamicCodeGeneration"> @@ -7748,6 +9367,22 @@ <c>true</c> if the <see cref="T:System.SerializableAttribute"/> attribute will be ignored when serializing and deserializing types; otherwise, <c>false</c>. </value> </member> + <member name="P:Newtonsoft.Json.Serialization.DefaultContractResolver.IgnoreIsSpecifiedMembers"> + <summary> + Gets or sets a value indicating whether to ignore IsSpecified members when serializing and deserializing types. + </summary> + <value> + <c>true</c> if the IsSpecified members will be ignored when serializing and deserializing types; otherwise, <c>false</c>. + </value> + </member> + <member name="P:Newtonsoft.Json.Serialization.DefaultContractResolver.IgnoreShouldSerializeMembers"> + <summary> + Gets or sets a value indicating whether to ignore ShouldSerialize members when serializing and deserializing types. + </summary> + <value> + <c>true</c> if the ShouldSerialize members will be ignored when serializing and deserializing types; otherwise, <c>false</c>. + </value> + </member> <member name="P:Newtonsoft.Json.Serialization.DefaultContractResolver.NamingStrategy"> <summary> Gets or sets the naming strategy used to resolve how property names and dictionary keys are serialized. @@ -7758,17 +9393,6 @@ <summary> Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.DefaultContractResolver"/> class. </summary> - </member> - <member name="M:Newtonsoft.Json.Serialization.DefaultContractResolver.#ctor(System.Boolean)"> - <summary> - Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.DefaultContractResolver"/> class. - </summary> - <param name="shareCache"> - If set to <c>true</c> the <see cref="T:Newtonsoft.Json.Serialization.DefaultContractResolver"/> 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 <see cref="T:Newtonsoft.Json.Serialization.DefaultContractResolver"/> instances with the <see cref="T:Newtonsoft.Json.JsonSerializer"/>. - </param> </member> <member name="M:Newtonsoft.Json.Serialization.DefaultContractResolver.ResolveContract(System.Type)"> <summary> @@ -7900,6 +9524,13 @@ <param name="propertyName">Name of the property.</param> <returns>Resolved name of the property.</returns> </member> + <member name="M:Newtonsoft.Json.Serialization.DefaultContractResolver.ResolveExtensionDataName(System.String)"> + <summary> + Resolves the name of the extension data. By default no changes are made to extension data names. + </summary> + <param name="extensionDataName">Name of the extension data.</param> + <returns>Resolved name of the extension data.</returns> + </member> <member name="M:Newtonsoft.Json.Serialization.DefaultContractResolver.ResolveDictionaryKey(System.String)"> <summary> Resolves the key of the dictionary. By default <see cref="M:Newtonsoft.Json.Serialization.DefaultContractResolver.ResolvePropertyName(System.String)"/> is used to resolve dictionary keys. @@ -7931,6 +9562,11 @@ The default serialization binder used when resolving and loading classes from type names. </summary> </member> + <member name="M:Newtonsoft.Json.Serialization.DefaultSerializationBinder.#ctor"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.DefaultSerializationBinder"/> class. + </summary> + </member> <member name="M:Newtonsoft.Json.Serialization.DefaultSerializationBinder.BindToType(System.String,System.String)"> <summary> When overridden in a derived class, controls the binding of a serialized object to a type. @@ -7946,8 +9582,8 @@ When overridden in a derived class, controls the binding of a serialized object to a type. </summary> <param name="serializedType">The type of the object the formatter creates a new instance of.</param> - <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly"/> name of the serialized object. </param> - <param name="typeName">Specifies the <see cref="T:System.Type"/> name of the serialized object. </param> + <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly"/> name of the serialized object.</param> + <param name="typeName">Specifies the <see cref="T:System.Type"/> name of the serialized object.</param> </member> <member name="T:Newtonsoft.Json.Serialization.DiagnosticsTraceWriter"> <summary> @@ -7957,8 +9593,8 @@ <member name="P:Newtonsoft.Json.Serialization.DiagnosticsTraceWriter.LevelFilter"> <summary> Gets the <see cref="T:System.Diagnostics.TraceLevel"/> that will be used to filter the trace messages passed to the writer. - For example a filter level of <code>Info</code> will exclude <code>Verbose</code> messages and include <code>Info</code>, - <code>Warning</code> and <code>Error</code> messages. + For example a filter level of <see cref="F:System.Diagnostics.TraceLevel.Info"/> will exclude <see cref="F:System.Diagnostics.TraceLevel.Verbose"/> messages and include <see cref="F:System.Diagnostics.TraceLevel.Info"/>, + <see cref="F:System.Diagnostics.TraceLevel.Warning"/> and <see cref="F:System.Diagnostics.TraceLevel.Error"/> messages. </summary> <value> The <see cref="T:System.Diagnostics.TraceLevel"/> that will be used to filter the trace messages passed to the writer. @@ -8090,7 +9726,7 @@ <summary> Returns a collection of all of the attributes, or an empty collection if there are no attributes. </summary> - <param name="inherit">When true, look up the hierarchy chain for the inherited custom attribute.</param> + <param name="inherit">When <c>true</c>, look up the hierarchy chain for the inherited custom attribute.</param> <returns>A collection of <see cref="T:System.Attribute"/>s, or an empty collection.</returns> </member> <member name="M:Newtonsoft.Json.Serialization.IAttributeProvider.GetAttributes(System.Type,System.Boolean)"> @@ -8098,12 +9734,12 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. </summary> <param name="attributeType">The type of the attributes.</param> - <param name="inherit">When true, look up the hierarchy chain for the inherited custom attribute.</param> + <param name="inherit">When <c>true</c>, look up the hierarchy chain for the inherited custom attribute.</param> <returns>A collection of <see cref="T:System.Attribute"/>s, or an empty collection.</returns> </member> <member name="T:Newtonsoft.Json.Serialization.IContractResolver"> <summary> - Used by <see cref="T:Newtonsoft.Json.JsonSerializer"/> to resolves a <see cref="T:Newtonsoft.Json.Serialization.JsonContract"/> for a given <see cref="T:System.Type"/>. + Used by <see cref="T:Newtonsoft.Json.JsonSerializer"/> to resolve a <see cref="T:Newtonsoft.Json.Serialization.JsonContract"/> for a given <see cref="T:System.Type"/>. </summary> <example> <code lang="cs" source="..\Src\Newtonsoft.Json.Tests\Documentation\SerializationTests.cs" region="ReducingSerializedJsonSizeContractResolverObject" title="IContractResolver Class" /> @@ -8117,46 +9753,6 @@ <param name="type">The type to resolve a contract for.</param> <returns>The contract for a given type.</returns> </member> - <member name="T:Newtonsoft.Json.Serialization.NamingStrategy"> - <summary> - A base class for resolving how property names and dictionary keys are serialized. - </summary> - </member> - <member name="P:Newtonsoft.Json.Serialization.NamingStrategy.ProcessDictionaryKeys"> - <summary> - A flag indicating whether dictionary keys should be processed. - Defaults to <c>false</c>. - </summary> - </member> - <member name="P:Newtonsoft.Json.Serialization.NamingStrategy.OverrideSpecifiedNames"> - <summary> - A flag indicating whether explicitly specified property names, - e.g. a property name customized with a <see cref="T:Newtonsoft.Json.JsonPropertyAttribute"/>, should be processed. - Defaults to <c>false</c>. - </summary> - </member> - <member name="M:Newtonsoft.Json.Serialization.NamingStrategy.GetPropertyName(System.String,System.Boolean)"> - <summary> - Gets the serialized name for a given property name. - </summary> - <param name="name">The initial property name.</param> - <param name="hasSpecifiedName">A flag indicating whether the property has had a name explicitly specfied.</param> - <returns>The serialized property name.</returns> - </member> - <member name="M:Newtonsoft.Json.Serialization.NamingStrategy.GetDictionaryKey(System.String)"> - <summary> - Gets the serialized key for a given dictionary key. - </summary> - <param name="key">The initial dictionary key.</param> - <returns>The serialized dictionary key.</returns> - </member> - <member name="M:Newtonsoft.Json.Serialization.NamingStrategy.ResolvePropertyName(System.String)"> - <summary> - Resolves the specified property name. - </summary> - <param name="name">The property name to resolve.</param> - <returns>The resolved property name.</returns> - </member> <member name="T:Newtonsoft.Json.Serialization.IReferenceResolver"> <summary> Used to resolve references when serializing and deserializing JSON by the <see cref="T:Newtonsoft.Json.JsonSerializer"/>. @@ -8168,11 +9764,11 @@ </summary> <param name="context">The serialization context.</param> <param name="reference">The reference to resolve.</param> - <returns>The object that</returns> + <returns>The object that was resolved from the reference.</returns> </member> <member name="M:Newtonsoft.Json.Serialization.IReferenceResolver.GetReference(System.Object,System.Object)"> <summary> - Gets the reference for the sepecified object. + Gets the reference for the specified object. </summary> <param name="context">The serialization context.</param> <param name="value">The object to get a reference for.</param> @@ -8196,6 +9792,27 @@ <param name="reference">The reference.</param> <param name="value">The object to reference.</param> </member> + <member name="T:Newtonsoft.Json.Serialization.ISerializationBinder"> + <summary> + Allows users to control class loading and mandate what class to load. + </summary> + </member> + <member name="M:Newtonsoft.Json.Serialization.ISerializationBinder.BindToType(System.String,System.String)"> + <summary> + When implemented, controls the binding of a serialized object to a type. + </summary> + <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly"/> name of the serialized object.</param> + <param name="typeName">Specifies the <see cref="T:System.Type"/> name of the serialized object</param> + <returns>The type of the object the formatter creates a new instance of.</returns> + </member> + <member name="M:Newtonsoft.Json.Serialization.ISerializationBinder.BindToName(System.Type,System.String@,System.String@)"> + <summary> + When implemented, controls the binding of a serialized object to a type. + </summary> + <param name="serializedType">The type of the object the formatter creates a new instance of.</param> + <param name="assemblyName">Specifies the <see cref="T:System.Reflection.Assembly"/> name of the serialized object.</param> + <param name="typeName">Specifies the <see cref="T:System.Type"/> name of the serialized object.</param> + </member> <member name="T:Newtonsoft.Json.Serialization.ITraceWriter"> <summary> Represents a trace writer. @@ -8204,8 +9821,8 @@ <member name="P:Newtonsoft.Json.Serialization.ITraceWriter.LevelFilter"> <summary> Gets the <see cref="T:System.Diagnostics.TraceLevel"/> that will be used to filter the trace messages passed to the writer. - For example a filter level of <code>Info</code> will exclude <code>Verbose</code> messages and include <code>Info</code>, - <code>Warning</code> and <code>Error</code> messages. + For example a filter level of <see cref="F:System.Diagnostics.TraceLevel.Info"/> will exclude <see cref="F:System.Diagnostics.TraceLevel.Verbose"/> messages and include <see cref="F:System.Diagnostics.TraceLevel.Info"/>, + <see cref="F:System.Diagnostics.TraceLevel.Warning"/> and <see cref="F:System.Diagnostics.TraceLevel.Error"/> messages. </summary> <value>The <see cref="T:System.Diagnostics.TraceLevel"/> that will be used to filter the trace messages passed to the writer.</value> </member> @@ -8394,36 +10011,6 @@ </summary> <value>The methods called when an error is thrown during the serialization of the object.</value> </member> - <member name="P:Newtonsoft.Json.Serialization.JsonContract.OnDeserialized"> - <summary> - Gets or sets the method called immediately after deserialization of the object. - </summary> - <value>The method called immediately after deserialization of the object.</value> - </member> - <member name="P:Newtonsoft.Json.Serialization.JsonContract.OnDeserializing"> - <summary> - Gets or sets the method called during deserialization of the object. - </summary> - <value>The method called during deserialization of the object.</value> - </member> - <member name="P:Newtonsoft.Json.Serialization.JsonContract.OnSerialized"> - <summary> - Gets or sets the method called after serialization of the object graph. - </summary> - <value>The method called after serialization of the object graph.</value> - </member> - <member name="P:Newtonsoft.Json.Serialization.JsonContract.OnSerializing"> - <summary> - Gets or sets the method called before serialization of the object. - </summary> - <value>The method called before serialization of the object.</value> - </member> - <member name="P:Newtonsoft.Json.Serialization.JsonContract.OnError"> - <summary> - Gets or sets the method called when an error is thrown during the serialization of the object. - </summary> - <value>The method called when an error is thrown during the serialization of the object.</value> - </member> <member name="P:Newtonsoft.Json.Serialization.JsonContract.DefaultCreator"> <summary> Gets or sets the default creator method used to create the object. @@ -8432,7 +10019,7 @@ </member> <member name="P:Newtonsoft.Json.Serialization.JsonContract.DefaultCreatorNonPublic"> <summary> - 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. </summary> <value><c>true</c> if the default object creator is non-public; otherwise, <c>false</c>.</value> </member> @@ -8440,12 +10027,6 @@ <summary> Contract details for a <see cref="T:System.Type"/> used by the <see cref="T:Newtonsoft.Json.JsonSerializer"/>. </summary> - </member> - <member name="P:Newtonsoft.Json.Serialization.JsonDictionaryContract.PropertyNameResolver"> - <summary> - Gets or sets the property name resolver. - </summary> - <value>The property name resolver.</value> </member> <member name="P:Newtonsoft.Json.Serialization.JsonDictionaryContract.DictionaryKeyResolver"> <summary> @@ -8513,9 +10094,9 @@ </member> <member name="P:Newtonsoft.Json.Serialization.JsonISerializableContract.ISerializableCreator"> <summary> - Gets or sets the ISerializable object constructor. + Gets or sets the <see cref="T:System.Runtime.Serialization.ISerializable"/> object constructor. </summary> - <value>The ISerializable object constructor.</value> + <value>The <see cref="T:System.Runtime.Serialization.ISerializable"/> object constructor.</value> </member> <member name="M:Newtonsoft.Json.Serialization.JsonISerializableContract.#ctor(System.Type)"> <summary> @@ -8553,35 +10134,22 @@ A value indicating whether the object's properties are required. </value> </member> + <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.ItemNullValueHandling"> + <summary> + Gets or sets how the object's properties with null values are handled during serialization and deserialization. + </summary> + <value>How the object's properties with null values are handled during serialization and deserialization.</value> + </member> <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.Properties"> <summary> Gets the object's properties. </summary> <value>The object's properties.</value> </member> - <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.ConstructorParameters"> - <summary> - Gets the constructor parameters required for any non-default constructor - </summary> - </member> <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.CreatorParameters"> <summary> Gets a collection of <see cref="T:Newtonsoft.Json.Serialization.JsonProperty"/> instances that define the parameters used with <see cref="P:Newtonsoft.Json.Serialization.JsonObjectContract.OverrideCreator"/>. </summary> - </member> - <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.OverrideConstructor"> - <summary> - Gets or sets the override constructor used to create the object. - This is set when a constructor is marked up using the - JsonConstructor attribute. - </summary> - <value>The override constructor.</value> - </member> - <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.ParametrizedConstructor"> - <summary> - Gets or sets the parametrized constructor used to create the object. - </summary> - <value>The parametrized constructor.</value> </member> <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.OverrideCreator"> <summary> @@ -8604,6 +10172,12 @@ <summary> Gets or sets the extension data value type. </summary> + </member> + <member name="P:Newtonsoft.Json.Serialization.JsonObjectContract.ExtensionDataNameResolver"> + <summary> + Gets or sets the extension data name resolver. + </summary> + <value>The extension data name resolver.</value> </member> <member name="M:Newtonsoft.Json.Serialization.JsonObjectContract.#ctor(System.Type)"> <summary> @@ -8672,7 +10246,7 @@ <member name="P:Newtonsoft.Json.Serialization.JsonProperty.Converter"> <summary> Gets or sets the <see cref="T:Newtonsoft.Json.JsonConverter" /> 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. </summary> <value>The converter.</value> </member> @@ -8758,9 +10332,9 @@ </member> <member name="P:Newtonsoft.Json.Serialization.JsonProperty.ShouldSerialize"> <summary> - 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. </summary> - <value>A predicate used to determine whether the property should be serialize.</value> + <value>A predicate used to determine whether the property should be serialized.</value> </member> <member name="P:Newtonsoft.Json.Serialization.JsonProperty.ShouldDeserialize"> <summary> @@ -8802,13 +10376,13 @@ </member> <member name="P:Newtonsoft.Json.Serialization.JsonProperty.ItemTypeNameHandling"> <summary> - 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. </summary> <value>The collection's items type name handling.</value> </member> <member name="P:Newtonsoft.Json.Serialization.JsonProperty.ItemReferenceLoopHandling"> <summary> - 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. </summary> <value>The collection's items reference loop handling.</value> </member> @@ -8839,7 +10413,7 @@ <member name="M:Newtonsoft.Json.Serialization.JsonPropertyCollection.GetClosestMatchProperty(System.String)"> <summary> Gets the closest matching <see cref="T:Newtonsoft.Json.Serialization.JsonProperty"/> object. - First attempts to get an exact case match of propertyName and then + First attempts to get an exact case match of <paramref name="propertyName"/> and then a case insensitive match. </summary> <param name="propertyName">Name of the property.</param> @@ -8866,11 +10440,11 @@ </member> <member name="M:Newtonsoft.Json.Serialization.JsonTypeReflector.CreateJsonConverterInstance(System.Type,System.Object[])"> <summary> - Lookup and create an instance of the JsonConverter type described by the argument. + Lookup and create an instance of the <see cref="T:Newtonsoft.Json.JsonConverter"/> type described by the argument. </summary> - <param name="converterType">The JsonConverter type to create.</param> + <param name="converterType">The <see cref="T:Newtonsoft.Json.JsonConverter"/> type to create.</param> <param name="converterArgs">Optional arguments to pass to an initializing constructor of the JsonConverter. - If null, the default constructor is used.</param> + If <c>null</c>, the default constructor is used.</param> </member> <member name="T:Newtonsoft.Json.Serialization.MemoryTraceWriter"> <summary> @@ -8881,8 +10455,8 @@ <member name="P:Newtonsoft.Json.Serialization.MemoryTraceWriter.LevelFilter"> <summary> Gets the <see cref="T:System.Diagnostics.TraceLevel"/> that will be used to filter the trace messages passed to the writer. - For example a filter level of <code>Info</code> will exclude <code>Verbose</code> messages and include <code>Info</code>, - <code>Warning</code> and <code>Error</code> messages. + For example a filter level of <see cref="F:System.Diagnostics.TraceLevel.Info"/> will exclude <see cref="F:System.Diagnostics.TraceLevel.Verbose"/> messages and include <see cref="F:System.Diagnostics.TraceLevel.Info"/>, + <see cref="F:System.Diagnostics.TraceLevel.Warning"/> and <see cref="F:System.Diagnostics.TraceLevel.Error"/> messages. </summary> <value> The <see cref="T:System.Diagnostics.TraceLevel"/> that will be used to filter the trace messages passed to the writer. @@ -8915,6 +10489,59 @@ A <see cref="T:System.String"/> of the most recent trace messages. </returns> </member> + <member name="T:Newtonsoft.Json.Serialization.NamingStrategy"> + <summary> + A base class for resolving how property names and dictionary keys are serialized. + </summary> + </member> + <member name="P:Newtonsoft.Json.Serialization.NamingStrategy.ProcessDictionaryKeys"> + <summary> + A flag indicating whether dictionary keys should be processed. + Defaults to <c>false</c>. + </summary> + </member> + <member name="P:Newtonsoft.Json.Serialization.NamingStrategy.ProcessExtensionDataNames"> + <summary> + A flag indicating whether extension data names should be processed. + Defaults to <c>false</c>. + </summary> + </member> + <member name="P:Newtonsoft.Json.Serialization.NamingStrategy.OverrideSpecifiedNames"> + <summary> + A flag indicating whether explicitly specified property names, + e.g. a property name customized with a <see cref="T:Newtonsoft.Json.JsonPropertyAttribute"/>, should be processed. + Defaults to <c>false</c>. + </summary> + </member> + <member name="M:Newtonsoft.Json.Serialization.NamingStrategy.GetPropertyName(System.String,System.Boolean)"> + <summary> + Gets the serialized name for a given property name. + </summary> + <param name="name">The initial property name.</param> + <param name="hasSpecifiedName">A flag indicating whether the property has had a name explicitly specified.</param> + <returns>The serialized property name.</returns> + </member> + <member name="M:Newtonsoft.Json.Serialization.NamingStrategy.GetExtensionDataName(System.String)"> + <summary> + Gets the serialized name for a given extension data name. + </summary> + <param name="name">The initial extension data name.</param> + <returns>The serialized extension data name.</returns> + </member> + <member name="M:Newtonsoft.Json.Serialization.NamingStrategy.GetDictionaryKey(System.String)"> + <summary> + Gets the serialized key for a given dictionary key. + </summary> + <param name="key">The initial dictionary key.</param> + <returns>The serialized dictionary key.</returns> + </member> + <member name="M:Newtonsoft.Json.Serialization.NamingStrategy.ResolvePropertyName(System.String)"> + <summary> + Resolves the specified property name. + </summary> + <param name="name">The property name to resolve.</param> + <returns>The resolved property name.</returns> + </member> <member name="T:Newtonsoft.Json.Serialization.ObjectConstructor`1"> <summary> Represents a method that constructs an object. @@ -8941,7 +10568,7 @@ <summary> Returns a collection of all of the attributes, or an empty collection if there are no attributes. </summary> - <param name="inherit">When true, look up the hierarchy chain for the inherited custom attribute.</param> + <param name="inherit">When <c>true</c>, look up the hierarchy chain for the inherited custom attribute.</param> <returns>A collection of <see cref="T:System.Attribute"/>s, or an empty collection.</returns> </member> <member name="M:Newtonsoft.Json.Serialization.ReflectionAttributeProvider.GetAttributes(System.Type,System.Boolean)"> @@ -8949,7 +10576,7 @@ Returns a collection of attributes, identified by type, or an empty collection if there are no attributes. </summary> <param name="attributeType">The type of the attributes.</param> - <param name="inherit">When true, look up the hierarchy chain for the inherited custom attribute.</param> + <param name="inherit">When <c>true</c>, look up the hierarchy chain for the inherited custom attribute.</param> <returns>A collection of <see cref="T:System.Attribute"/>s, or an empty collection.</returns> </member> <member name="T:Newtonsoft.Json.Serialization.ReflectionValueProvider"> @@ -8977,6 +10604,50 @@ <param name="target">The target to get the value from.</param> <returns>The value.</returns> </member> + <member name="T:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy"> + <summary> + A snake case naming strategy. + </summary> + </member> + <member name="M:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy.#ctor(System.Boolean,System.Boolean)"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy"/> class. + </summary> + <param name="processDictionaryKeys"> + A flag indicating whether dictionary keys should be processed. + </param> + <param name="overrideSpecifiedNames"> + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a <see cref="T:Newtonsoft.Json.JsonPropertyAttribute"/>. + </param> + </member> + <member name="M:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy.#ctor(System.Boolean,System.Boolean,System.Boolean)"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy"/> class. + </summary> + <param name="processDictionaryKeys"> + A flag indicating whether dictionary keys should be processed. + </param> + <param name="overrideSpecifiedNames"> + A flag indicating whether explicitly specified property names should be processed, + e.g. a property name customized with a <see cref="T:Newtonsoft.Json.JsonPropertyAttribute"/>. + </param> + <param name="processExtensionDataNames"> + A flag indicating whether extension data names should be processed. + </param> + </member> + <member name="M:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy.#ctor"> + <summary> + Initializes a new instance of the <see cref="T:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy"/> class. + </summary> + </member> + <member name="M:Newtonsoft.Json.Serialization.SnakeCaseNamingStrategy.ResolvePropertyName(System.String)"> + <summary> + Resolves the specified property name. + </summary> + <param name="name">The property name to resolve.</param> + <returns>The resolved property name.</returns> + </member> <member name="T:Newtonsoft.Json.StringEscapeHandling"> <summary> Specifies how strings are escaped when writing JSON text. @@ -8997,14 +10668,29 @@ HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped. </summary> </member> + <member name="T:Newtonsoft.Json.TypeNameAssemblyFormatHandling"> + <summary> + Indicates the method that will be used during deserialization for locating and loading assemblies. + </summary> + </member> + <member name="F:Newtonsoft.Json.TypeNameAssemblyFormatHandling.Simple"> + <summary> + 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 <c>LoadWithPartialName</c> method of the <see cref="T:System.Reflection.Assembly"/> class is used to load the assembly. + </summary> + </member> + <member name="F:Newtonsoft.Json.TypeNameAssemblyFormatHandling.Full"> + <summary> + In full mode, the assembly used during deserialization must match exactly the assembly used during serialization. The <c>Load</c> method of the <see cref="T:System.Reflection.Assembly"/> class is used to load the assembly. + </summary> + </member> <member name="T:Newtonsoft.Json.TypeNameHandling"> <summary> Specifies type name handling options for the <see cref="T:Newtonsoft.Json.JsonSerializer"/>. </summary> <remarks> - <see cref="T:Newtonsoft.Json.TypeNameHandling"/> should be used with caution when your application deserializes JSON from an external source. - Incoming types should be validated with a custom <see cref="T:System.Runtime.Serialization.SerializationBinder"/> - when deserializing with a value other than <c>TypeNameHandling.None</c>. + <see cref="P:Newtonsoft.Json.JsonSerializer.TypeNameHandling"/> should be used with caution when your application deserializes JSON from an external source. + Incoming types should be validated with a custom <see cref="P:Newtonsoft.Json.JsonSerializer.SerializationBinder"/> + when deserializing with a value other than <see cref="F:Newtonsoft.Json.TypeNameHandling.None"/>. </remarks> </member> <member name="F:Newtonsoft.Json.TypeNameHandling.None"> @@ -9030,20 +10716,23 @@ <member name="F:Newtonsoft.Json.TypeNameHandling.Auto"> <summary> 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 <see cref="M:Newtonsoft.Json.JsonConvert.SerializeObject(System.Object,System.Type,Newtonsoft.Json.JsonSerializerSettings)"/> + or <see cref="M:Newtonsoft.Json.JsonSerializer.Serialize(Newtonsoft.Json.JsonWriter,System.Object,System.Type)"/>. </summary> </member> <member name="M:Newtonsoft.Json.Utilities.CollectionUtils.IsNullOrEmpty``1(System.Collections.Generic.ICollection{``0})"> <summary> - Determines whether the collection is null or empty. + Determines whether the collection is <c>null</c> or empty. </summary> <param name="collection">The collection.</param> <returns> - <c>true</c> if the collection is null or empty; otherwise, <c>false</c>. + <c>true</c> if the collection is <c>null</c> or empty; otherwise, <c>false</c>. </returns> </member> <member name="M:Newtonsoft.Json.Utilities.CollectionUtils.AddRange``1(System.Collections.Generic.IList{``0},System.Collections.Generic.IEnumerable{``0})"> <summary> - Adds the elements of the specified collection to the specified generic IList. + Adds the elements of the specified collection to the specified generic <see cref="T:System.Collections.Generic.IList`1"/>. </summary> <param name="initial">The list to add to.</param> <param name="collection">The collection of elements to add.</param> @@ -9061,13 +10750,13 @@ is returned if assignable to the target type. </returns> </member> - <member name="M:Newtonsoft.Json.Utilities.DynamicProxyMetaObject`1.CallMethodWithResult(System.String,System.Dynamic.DynamicMetaObjectBinder,System.Linq.Expressions.Expression[],Newtonsoft.Json.Utilities.DynamicProxyMetaObject{`0}.Fallback,Newtonsoft.Json.Utilities.DynamicProxyMetaObject{`0}.Fallback)"> + <member name="M:Newtonsoft.Json.Utilities.DynamicProxyMetaObject`1.CallMethodWithResult(System.String,System.Dynamic.DynamicMetaObjectBinder,System.Collections.Generic.IEnumerable{System.Linq.Expressions.Expression},Newtonsoft.Json.Utilities.DynamicProxyMetaObject{`0}.Fallback,Newtonsoft.Json.Utilities.DynamicProxyMetaObject{`0}.Fallback)"> <summary> Helper method for generating a MetaObject which calls a specific method on Dynamic that returns a result </summary> </member> - <member name="M:Newtonsoft.Json.Utilities.DynamicProxyMetaObject`1.CallMethodReturnLast(System.String,System.Dynamic.DynamicMetaObjectBinder,System.Linq.Expressions.Expression[],Newtonsoft.Json.Utilities.DynamicProxyMetaObject{`0}.Fallback)"> + <member name="M:Newtonsoft.Json.Utilities.DynamicProxyMetaObject`1.CallMethodReturnLast(System.String,System.Dynamic.DynamicMetaObjectBinder,System.Collections.Generic.IEnumerable{System.Linq.Expressions.Expression},Newtonsoft.Json.Utilities.DynamicProxyMetaObject{`0}.Fallback)"> <summary> Helper method for generating a MetaObject which calls a specific method on Dynamic, but uses one of the arguments for @@ -9087,18 +10776,12 @@ with a restriction limiting our type </summary> </member> - <member name="M:Newtonsoft.Json.Utilities.EnumUtils.GetNamesAndValues``1"> + <member name="T:Newtonsoft.Json.Utilities.ImmutableCollectionsUtils"> <summary> - Gets a dictionary of the names and values of an Enum type. + Helper class for serializing immutable collections. + Note that this is used by all builds, even those that don't support immutable collections, in case the DLL is GACed + https://github.com/JamesNK/Newtonsoft.Json/issues/652 </summary> - <returns></returns> - </member> - <member name="M:Newtonsoft.Json.Utilities.EnumUtils.GetNamesAndValues``1(System.Type)"> - <summary> - Gets a dictionary of the names and values of an Enum type. - </summary> - <param name="enumType">The enum type to get names and values for.</param> - <returns></returns> </member> <member name="M:Newtonsoft.Json.Utilities.ReflectionUtils.GetCollectionItemType(System.Type)"> <summary> @@ -9171,12 +10854,12 @@ </member> <member name="T:Newtonsoft.Json.Utilities.StringBuffer"> <summary> - Builds a string. Unlike StringBuilder this class lets you reuse it's internal buffer. + Builds a string. Unlike <see cref="T:System.Text.StringBuilder"/> this class lets you reuse its internal buffer. </summary> </member> <member name="M:Newtonsoft.Json.Utilities.StringUtils.IsWhiteSpace(System.String)"> <summary> - 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 <c>false</c>. </summary> <param name="s">The string to test whether it is all white space.</param> <returns> @@ -9192,12 +10875,12 @@ <summary> An exception has been thrown, which has left the <see cref="T:Newtonsoft.Json.JsonWriter"/> in an invalid state. You may call the <see cref="M:Newtonsoft.Json.JsonWriter.Close"/> method to put the <see cref="T:Newtonsoft.Json.JsonWriter"/> in the <c>Closed</c> state. - Any other <see cref="T:Newtonsoft.Json.JsonWriter"/> method calls results in an <see cref="T:System.InvalidOperationException"/> being thrown. + Any other <see cref="T:Newtonsoft.Json.JsonWriter"/> method calls result in an <see cref="T:System.InvalidOperationException"/> being thrown. </summary> </member> <member name="F:Newtonsoft.Json.WriteState.Closed"> <summary> - The <see cref="M:Newtonsoft.Json.JsonWriter.Close"/> method has been called. + The <see cref="M:Newtonsoft.Json.JsonWriter.Close"/> method has been called. </summary> </member> <member name="F:Newtonsoft.Json.WriteState.Object"> @@ -9207,7 +10890,7 @@ </member> <member name="F:Newtonsoft.Json.WriteState.Array"> <summary> - A array is being written. + An array is being written. </summary> </member> <member name="F:Newtonsoft.Json.WriteState.Constructor"> @@ -9222,7 +10905,7 @@ </member> <member name="F:Newtonsoft.Json.WriteState.Start"> <summary> - A write method has not been called. + A <see cref="T:Newtonsoft.Json.JsonWriter"/> write method has not been called. </summary> </member> </members> -- Gitblit v1.9.3