diff --git a/Src/Newtonsoft.Json/Bson/BsonReader.cs b/Src/Newtonsoft.Json/Bson/BsonReader.cs index 20d6edb3..00ecc7f3 100644 --- a/Src/Newtonsoft.Json/Bson/BsonReader.cs +++ b/Src/Newtonsoft.Json/Bson/BsonReader.cs @@ -35,7 +35,7 @@ using Newtonsoft.Json.Linq; namespace Newtonsoft.Json.Bson { /// - /// 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. /// public class BsonReader : JsonReader { diff --git a/Src/Newtonsoft.Json/Bson/BsonWriter.cs b/Src/Newtonsoft.Json/Bson/BsonWriter.cs index 39667514..f46b67c3 100644 --- a/Src/Newtonsoft.Json/Bson/BsonWriter.cs +++ b/Src/Newtonsoft.Json/Bson/BsonWriter.cs @@ -38,7 +38,7 @@ using System.Globalization; namespace Newtonsoft.Json.Bson { /// - /// 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. /// public class BsonWriter : JsonWriter { diff --git a/Src/Newtonsoft.Json/JsonConvert.cs b/Src/Newtonsoft.Json/JsonConvert.cs index 98ed77de..965a1cc2 100644 --- a/Src/Newtonsoft.Json/JsonConvert.cs +++ b/Src/Newtonsoft.Json/JsonConvert.cs @@ -534,7 +534,7 @@ namespace Newtonsoft.Json /// Serializes the specified object to a JSON string using formatting. /// /// The object to serialize. - /// Indicates how the output is formatted. + /// Indicates how the output should be formatted. /// /// A JSON string representation of the object. /// @@ -547,7 +547,7 @@ namespace Newtonsoft.Json /// Serializes the specified object to a JSON string using a collection of . /// /// The object to serialize. - /// A collection converters used while serializing. + /// A collection of converters used while serializing. /// A JSON string representation of the object. public static string SerializeObject(object value, params JsonConverter[] converters) { @@ -562,8 +562,8 @@ namespace Newtonsoft.Json /// Serializes the specified object to a JSON string using formatting and a collection of . /// /// The object to serialize. - /// Indicates how the output is formatted. - /// A collection converters used while serializing. + /// Indicates how the output should be formatted. + /// A collection of converters used while serializing. /// A JSON string representation of the object. public static string SerializeObject(object value, Formatting formatting, params JsonConverter[] converters) { @@ -613,7 +613,7 @@ namespace Newtonsoft.Json /// Serializes the specified object to a JSON string using formatting and . /// /// The object to serialize. - /// Indicates how the output is formatted. + /// Indicates how the output should be formatted. /// The used to serialize the object. /// If this is null, default serialization settings will be used. /// @@ -628,7 +628,7 @@ namespace Newtonsoft.Json /// Serializes the specified object to a JSON string using a type, formatting and . /// /// The object to serialize. - /// Indicates how the output is formatted. + /// Indicates how the output should be formatted. /// The used to serialize the object. /// If this is null, default serialization settings will be used. /// @@ -668,7 +668,7 @@ namespace Newtonsoft.Json /// /// The object to serialize. /// - /// A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + /// A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. /// [ObsoleteAttribute("SerializeObjectAsync is obsolete. Use the Task.Factory.StartNew method to serialize JSON asynchronously: Task.Factory.StartNew(() => JsonConvert.SerializeObject(value))")] public static Task SerializeObjectAsync(object value) @@ -681,9 +681,9 @@ namespace Newtonsoft.Json /// Serialization will happen on a new thread. /// /// The object to serialize. - /// Indicates how the output is formatted. + /// Indicates how the output should be formatted. /// - /// A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + /// A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. /// [ObsoleteAttribute("SerializeObjectAsync is obsolete. Use the Task.Factory.StartNew method to serialize JSON asynchronously: Task.Factory.StartNew(() => JsonConvert.SerializeObject(value, formatting))")] public static Task SerializeObjectAsync(object value, Formatting formatting) @@ -696,11 +696,11 @@ namespace Newtonsoft.Json /// Serialization will happen on a new thread. /// /// The object to serialize. - /// Indicates how the output is formatted. + /// Indicates how the output should be formatted. /// The used to serialize the object. /// If this is null, default serialization settings will be used. /// - /// A task that represents the asynchronous serialize operation. The value of the TResult parameter contains a JSON string representation of the object. + /// A task that represents the asynchronous serialization operation. The value of the TResult parameter contains a JSON string representation of the object. /// [ObsoleteAttribute("SerializeObjectAsync is obsolete. Use the Task.Factory.StartNew method to serialize JSON asynchronously: Task.Factory.StartNew(() => JsonConvert.SerializeObject(value, formatting, settings))")] public static Task SerializeObjectAsync(object value, Formatting formatting, JsonSerializerSettings settings) @@ -980,7 +980,7 @@ namespace Newtonsoft.Json /// If this is null, default serialization settings will be used. /// /// - /// A task that represents the asynchronous populate operation. + /// A task that represents the asynchronous population operation. /// [ObsoleteAttribute("PopulateObjectAsync is obsolete. Use the Task.Factory.StartNew method to populate an object with JSON values asynchronously: Task.Factory.StartNew(() => JsonConvert.PopulateObject(value, target, settings))")] public static Task PopulateObjectAsync(string value, object target, JsonSerializerSettings settings) @@ -1033,7 +1033,7 @@ namespace Newtonsoft.Json /// Deserializes the from a JSON string. /// /// The JSON string. - /// The deserialized XmlNode + /// The deserialized XmlNode. public static XmlDocument DeserializeXmlNode(string value) { return DeserializeXmlNode(value, null); @@ -1044,7 +1044,7 @@ namespace Newtonsoft.Json /// /// The JSON string. /// The name of the root element to append when deserializing. - /// The deserialized XmlNode + /// The deserialized XmlNode. public static XmlDocument DeserializeXmlNode(string value, string deserializeRootElementName) { return DeserializeXmlNode(value, deserializeRootElementName, false); @@ -1060,7 +1060,7 @@ namespace Newtonsoft.Json /// A flag to indicate whether to write the Json.NET array attribute. /// This attribute helps preserve arrays when converting the written XML back to JSON. /// - /// The deserialized XmlNode + /// The deserialized XmlNode. public static XmlDocument DeserializeXmlNode(string value, string deserializeRootElementName, bool writeArrayAttribute) { XmlNodeConverter converter = new XmlNodeConverter(); @@ -1111,7 +1111,7 @@ namespace Newtonsoft.Json /// Deserializes the from a JSON string. /// /// The JSON string. - /// The deserialized XNode + /// The deserialized XNode. public static XDocument DeserializeXNode(string value) { return DeserializeXNode(value, null); @@ -1122,7 +1122,7 @@ namespace Newtonsoft.Json /// /// The JSON string. /// The name of the root element to append when deserializing. - /// The deserialized XNode + /// The deserialized XNode. public static XDocument DeserializeXNode(string value, string deserializeRootElementName) { return DeserializeXNode(value, deserializeRootElementName, false); @@ -1138,7 +1138,7 @@ namespace Newtonsoft.Json /// A flag to indicate whether to write the Json.NET array attribute. /// This attribute helps preserve arrays when converting the written XML back to JSON. /// - /// The deserialized XNode + /// The deserialized XNode. public static XDocument DeserializeXNode(string value, string deserializeRootElementName, bool writeArrayAttribute) { XmlNodeConverter converter = new XmlNodeConverter(); diff --git a/Src/Newtonsoft.Json/JsonException.cs b/Src/Newtonsoft.Json/JsonException.cs index 97ea7242..306916ac 100644 --- a/Src/Newtonsoft.Json/JsonException.cs +++ b/Src/Newtonsoft.Json/JsonException.cs @@ -74,8 +74,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/JsonReader.cs b/Src/Newtonsoft.Json/JsonReader.cs index 13ffcd57..0ac78138 100644 --- a/Src/Newtonsoft.Json/JsonReader.cs +++ b/Src/Newtonsoft.Json/JsonReader.cs @@ -606,9 +606,9 @@ namespace Newtonsoft.Json } /// - /// Reads the next JSON token from the stream as a . + /// Reads the next JSON token from the stream as a . /// - /// A . This method will return null at the end of an array. + /// A . This method will return null at the end of an array. public virtual double? ReadAsDouble() { JsonToken t = GetContentToken(); diff --git a/Src/Newtonsoft.Json/JsonReaderException.cs b/Src/Newtonsoft.Json/JsonReaderException.cs index 9f448c4b..e74b29dc 100644 --- a/Src/Newtonsoft.Json/JsonReaderException.cs +++ b/Src/Newtonsoft.Json/JsonReaderException.cs @@ -90,8 +90,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonReaderException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/JsonSerializationException.cs b/Src/Newtonsoft.Json/JsonSerializationException.cs index 1c872c78..5ba3ede4 100644 --- a/Src/Newtonsoft.Json/JsonSerializationException.cs +++ b/Src/Newtonsoft.Json/JsonSerializationException.cs @@ -72,8 +72,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonSerializationException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/JsonSerializerSettings.cs b/Src/Newtonsoft.Json/JsonSerializerSettings.cs index 9de2e8de..9b3f61d8 100644 --- a/Src/Newtonsoft.Json/JsonSerializerSettings.cs +++ b/Src/Newtonsoft.Json/JsonSerializerSettings.cs @@ -88,7 +88,7 @@ namespace Newtonsoft.Json internal MetadataPropertyHandling? _metadataPropertyHandling; /// - /// Gets or sets how reference loops (e.g. a class referencing itself) is handled. + /// Gets or sets how reference loops (e.g. a class referencing itself) are handled. /// /// Reference loop handling. public ReferenceLoopHandling ReferenceLoopHandling diff --git a/Src/Newtonsoft.Json/JsonTextReader.cs b/Src/Newtonsoft.Json/JsonTextReader.cs index f806884d..ff1f8a95 100644 --- a/Src/Newtonsoft.Json/JsonTextReader.cs +++ b/Src/Newtonsoft.Json/JsonTextReader.cs @@ -75,7 +75,7 @@ namespace Newtonsoft.Json /// /// Initializes a new instance of the class with the specified . /// - /// The TextReader containing the XML data to read. + /// The TextReader containing the JSON data to read. public JsonTextReader(TextReader reader) { if (reader == null) diff --git a/Src/Newtonsoft.Json/JsonTextWriter.cs b/Src/Newtonsoft.Json/JsonTextWriter.cs index 71975ea7..82ada632 100644 --- a/Src/Newtonsoft.Json/JsonTextWriter.cs +++ b/Src/Newtonsoft.Json/JsonTextWriter.cs @@ -143,7 +143,7 @@ namespace Newtonsoft.Json } /// - /// Creates an instance of the JsonTextWriter class using the specified . + /// Initializes a new instance of the JsonTextWriter class using the specified . /// /// The TextWriter to write to. public JsonTextWriter(TextWriter textWriter) diff --git a/Src/Newtonsoft.Json/JsonWriterException.cs b/Src/Newtonsoft.Json/JsonWriterException.cs index 475c2dba..7c0f1b8c 100644 --- a/Src/Newtonsoft.Json/JsonWriterException.cs +++ b/Src/Newtonsoft.Json/JsonWriterException.cs @@ -78,8 +78,8 @@ namespace Newtonsoft.Json /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonWriterException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/Linq/JArray.cs b/Src/Newtonsoft.Json/Linq/JArray.cs index ad73e028..eb6fc7a6 100644 --- a/Src/Newtonsoft.Json/Linq/JArray.cs +++ b/Src/Newtonsoft.Json/Linq/JArray.cs @@ -189,7 +189,7 @@ namespace Newtonsoft.Json.Linq /// Creates a from an object. /// /// The object that will be used to create . - /// A with the values of the specified object + /// A with the values of the specified object. public new static JArray FromObject(object o) { return FromObject(o, JsonSerializer.CreateDefault()); @@ -200,7 +200,7 @@ namespace Newtonsoft.Json.Linq /// /// The object that will be used to create . /// The that will be used to read the object. - /// A with the values of the specified object + /// A with the values of the specified object. public new static JArray FromObject(object o, JsonSerializer jsonSerializer) { JToken token = FromObjectInternal(o, jsonSerializer); diff --git a/Src/Newtonsoft.Json/Linq/JContainer.cs b/Src/Newtonsoft.Json/Linq/JContainer.cs index 0ad8a5ce..76b0c04a 100644 --- a/Src/Newtonsoft.Json/Linq/JContainer.cs +++ b/Src/Newtonsoft.Json/Linq/JContainer.cs @@ -685,16 +685,16 @@ namespace Newtonsoft.Json.Linq } /// - /// Creates an that can be used to add tokens to the . + /// Creates a that can be used to add tokens to the . /// - /// An that is ready to have content written to it. + /// A that is ready to have content written to it. public JsonWriter CreateWriter() { return new JTokenWriter(this); } /// - /// Replaces the children nodes of this token with the specified content. + /// Replaces the child nodes of this token with the specified content. /// /// The content. public void ReplaceAll(object content) diff --git a/Src/Newtonsoft.Json/Linq/JObject.cs b/Src/Newtonsoft.Json/Linq/JObject.cs index b9098ab1..96f1ed83 100644 --- a/Src/Newtonsoft.Json/Linq/JObject.cs +++ b/Src/Newtonsoft.Json/Linq/JObject.cs @@ -270,9 +270,9 @@ namespace Newtonsoft.Json.Linq } /// - /// Gets an of this object's property values. + /// Gets a of this object's property values. /// - /// An of this object's property values. + /// A of this object's property values. public JEnumerable PropertyValues() { return new JEnumerable(Properties().Select(p => p.Value)); @@ -343,7 +343,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Loads an from a . + /// Loads a from a . /// /// A that will be read for the content of the . /// A that contains the JSON that was read from the specified . @@ -356,7 +356,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Loads an from a . + /// Loads a from a . /// /// A that will be read for the content of the . /// The used to load the JSON. @@ -440,7 +440,7 @@ namespace Newtonsoft.Json.Linq /// Creates a from an object. /// /// The object that will be used to create . - /// A with the values of the specified object + /// A with the values of the specified object. public new static JObject FromObject(object o) { return FromObject(o, JsonSerializer.CreateDefault()); @@ -451,7 +451,7 @@ namespace Newtonsoft.Json.Linq /// /// The object that will be used to create . /// The that will be used to read the object. - /// A with the values of the specified object + /// A with the values of the specified object. public new static JObject FromObject(object o, JsonSerializer jsonSerializer) { JToken token = FromObjectInternal(o, jsonSerializer); @@ -583,7 +583,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Tries the get value. + /// Tries to get the with the specified property name. /// /// Name of the property. /// The value. @@ -683,7 +683,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Returns an enumerator that iterates through the collection. + /// Returns an enumerator that can be used to iterate through the collection. /// /// /// A that can be used to iterate through the collection. @@ -720,24 +720,11 @@ namespace Newtonsoft.Json.Linq // include custom type descriptor on JObject rather than use a provider because the properties are specific to a type #region ICustomTypeDescriptor - /// - /// Returns the properties for this instance of a component. - /// - /// - /// A that represents the properties for this component instance. - /// PropertyDescriptorCollection ICustomTypeDescriptor.GetProperties() { return ((ICustomTypeDescriptor)this).GetProperties(null); } - /// - /// Returns the properties for this instance of a component using the attribute array as a filter. - /// - /// An array of type that is used as a filter. - /// - /// A that represents the filtered properties for this component instance. - /// PropertyDescriptorCollection ICustomTypeDescriptor.GetProperties(Attribute[] attributes) { PropertyDescriptorCollection descriptors = new PropertyDescriptorCollection(null); @@ -750,114 +737,51 @@ namespace Newtonsoft.Json.Linq return descriptors; } - /// - /// Returns a collection of custom attributes for this instance of a component. - /// - /// - /// An containing the attributes for this object. - /// AttributeCollection ICustomTypeDescriptor.GetAttributes() { return AttributeCollection.Empty; } - /// - /// Returns the class name of this instance of a component. - /// - /// - /// The class name of the object, or null if the class does not have a name. - /// string ICustomTypeDescriptor.GetClassName() { return null; } - /// - /// Returns the name of this instance of a component. - /// - /// - /// The name of the object, or null if the object does not have a name. - /// string ICustomTypeDescriptor.GetComponentName() { return null; } - /// - /// Returns a type converter for this instance of a component. - /// - /// - /// A that is the converter for this object, or null if there is no for this object. - /// TypeConverter ICustomTypeDescriptor.GetConverter() { return new TypeConverter(); } - /// - /// Returns the default event for this instance of a component. - /// - /// - /// An that represents the default event for this object, or null if this object does not have events. - /// EventDescriptor ICustomTypeDescriptor.GetDefaultEvent() { return null; } - /// - /// Returns the default property for this instance of a component. - /// - /// - /// A that represents the default property for this object, or null if this object does not have properties. - /// PropertyDescriptor ICustomTypeDescriptor.GetDefaultProperty() { return null; } - /// - /// Returns an editor of the specified type for this instance of a component. - /// - /// A that represents the editor for this object. - /// - /// An of the specified type that is the editor for this object, or null if the editor cannot be found. - /// object ICustomTypeDescriptor.GetEditor(Type editorBaseType) { return null; } - /// - /// Returns the events for this instance of a component using the specified attribute array as a filter. - /// - /// An array of type that is used as a filter. - /// - /// An that represents the filtered events for this component instance. - /// EventDescriptorCollection ICustomTypeDescriptor.GetEvents(Attribute[] attributes) { return EventDescriptorCollection.Empty; } - /// - /// Returns the events for this instance of a component. - /// - /// - /// An that represents the events for this component instance. - /// EventDescriptorCollection ICustomTypeDescriptor.GetEvents() { return EventDescriptorCollection.Empty; } - /// - /// Returns an object that contains the property described by the specified property descriptor. - /// - /// A that represents the property whose owner is to be found. - /// - /// An that represents the owner of the specified property. - /// object ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor pd) { return null; diff --git a/Src/Newtonsoft.Json/Linq/JProperty.cs b/Src/Newtonsoft.Json/Linq/JProperty.cs index c68502a0..3b15175b 100644 --- a/Src/Newtonsoft.Json/Linq/JProperty.cs +++ b/Src/Newtonsoft.Json/Linq/JProperty.cs @@ -361,7 +361,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Loads an from a . + /// Loads a from a . /// /// A that will be read for the content of the . /// A that contains the JSON that was read from the specified . diff --git a/Src/Newtonsoft.Json/Linq/JPropertyDescriptor.cs b/Src/Newtonsoft.Json/Linq/JPropertyDescriptor.cs index 0b7b34eb..07aed646 100644 --- a/Src/Newtonsoft.Json/Linq/JPropertyDescriptor.cs +++ b/Src/Newtonsoft.Json/Linq/JPropertyDescriptor.cs @@ -66,8 +66,7 @@ namespace Newtonsoft.Json.Linq /// /// The value of a property for a given component. /// - /// The component with the property for which to retrieve the value. - /// + /// The component with the property for which to retrieve the value. public override object GetValue(object component) { JToken token = CastInstance(component)[Name]; @@ -78,8 +77,7 @@ namespace Newtonsoft.Json.Linq /// /// When overridden in a derived class, resets the value for this property of the component to the default value. /// - /// The component with the property value that is to be reset to the default value. - /// + /// The component with the property value that is to be reset to the default value. public override void ResetValue(object component) { } @@ -87,9 +85,8 @@ namespace Newtonsoft.Json.Linq /// /// When overridden in a derived class, sets the value of the component to a different value. /// - /// The component with the property value that is to be set. - /// The new value. - /// + /// The component with the property value that is to be set. + /// The new value. public override void SetValue(object component, object value) { JToken token = (value is JToken) ? (JToken)value : new JValue(value); @@ -113,7 +110,10 @@ namespace Newtonsoft.Json.Linq /// When overridden in a derived class, gets the type of the component this property is bound to. /// /// - /// A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. + /// A that represents the type of component this property is bound to. + /// When the or + /// + /// methods are invoked, the object specified might be an instance of this type. /// public override Type ComponentType { diff --git a/Src/Newtonsoft.Json/Linq/JToken.cs b/Src/Newtonsoft.Json/Linq/JToken.cs index 2a2818a5..4e71bed4 100644 --- a/Src/Newtonsoft.Json/Linq/JToken.cs +++ b/Src/Newtonsoft.Json/Linq/JToken.cs @@ -428,7 +428,7 @@ namespace Newtonsoft.Json.Linq /// /// Returns the JSON for this token using the given formatting and converters. /// - /// Indicates how the output is formatted. + /// Indicates how the output should be formatted. /// A collection of which will be used when writing the token. /// The JSON for this token using the given formatting and converters. public string ToString(Formatting formatting, params JsonConverter[] converters) @@ -1358,7 +1358,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Performs an explicit conversion from to . + /// Performs an explicit conversion from to . /// /// The value. /// The result of the conversion. @@ -1405,7 +1405,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Performs an explicit conversion from to . + /// Performs an explicit conversion from to . /// /// The value. /// The result of the conversion. @@ -1870,9 +1870,9 @@ namespace Newtonsoft.Json.Linq } /// - /// Creates an for this token. + /// Creates a for this token. /// - /// An that can be used to read this token and its descendants. + /// A that can be used to read this token and its descendants. public JsonReader CreateReader() { return new JTokenReader(this); @@ -1915,7 +1915,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Creates the specified .NET type from the . + /// Creates an instance of the specified .NET type from the . /// /// The object type that the token will be deserialized to. /// The new object created from the JSON value. @@ -1925,7 +1925,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Creates the specified .NET type from the . + /// Creates an instance of the specified .NET type from the . /// /// The object type that the token will be deserialized to. /// The new object created from the JSON value. @@ -2048,7 +2048,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Creates the specified .NET type from the using the specified . + /// Creates an instance of the specified .NET type from the using the specified . /// /// The object type that the token will be deserialized to. /// The that will be used when creating the object. @@ -2059,7 +2059,7 @@ namespace Newtonsoft.Json.Linq } /// - /// Creates the specified .NET type from the using the specified . + /// Creates an instance of the specified .NET type from the using the specified . /// /// The object type that the token will be deserialized to. /// The that will be used when creating the object. @@ -2077,9 +2077,9 @@ namespace Newtonsoft.Json.Linq /// /// Creates a from a . /// - /// An positioned at the token to read into this . + /// A positioned at the token to read into this . /// - /// An that contains the token and its descendant tokens + /// A that contains the token and its descendant tokens /// that were read from the reader. The runtime type of the token is determined /// by the token type of the first token encountered in the reader. /// @@ -2188,11 +2188,11 @@ namespace Newtonsoft.Json.Linq /// /// Creates a from a . /// - /// An positioned at the token to read into this . + /// A positioned at the token to read into this . /// The used to load the JSON. /// If this is null, default load settings will be used. /// - /// An that contains the token and its descendant tokens + /// A that contains the token and its descendant tokens /// that were read from the reader. The runtime type of the token is determined /// by the token type of the first token encountered in the reader. /// @@ -2204,9 +2204,9 @@ namespace Newtonsoft.Json.Linq /// /// Creates a from a . /// - /// An positioned at the token to read into this . + /// A positioned at the token to read into this . /// - /// An that contains the token and its descendant tokens + /// A that contains the token and its descendant tokens /// that were read from the reader. The runtime type of the token is determined /// by the token type of the first token encountered in the reader. /// @@ -2505,7 +2505,7 @@ namespace Newtonsoft.Json.Linq /// Gets a collection of annotations of the specified type for this . /// /// The type of the annotations to retrieve. - /// An that contains the annotations for this . + /// An that contains the annotations for this . public IEnumerable Annotations() where T : class { if (_annotations == null) diff --git a/Src/Newtonsoft.Json/Linq/JValue.cs b/Src/Newtonsoft.Json/Linq/JValue.cs index 4ed0ad7a..43ea4519 100644 --- a/Src/Newtonsoft.Json/Linq/JValue.cs +++ b/Src/Newtonsoft.Json/Linq/JValue.cs @@ -869,9 +869,6 @@ namespace Newtonsoft.Json.Linq /// /// true if the specified is equal to the current ; otherwise, false. /// - /// - /// The parameter is null. - /// public override bool Equals(object obj) { if (obj == null) @@ -1079,7 +1076,7 @@ namespace Newtonsoft.Json.Linq /// This instance is greater than . /// /// - /// is not the same type as this instance. + /// is not of the same type as this instance. /// public int CompareTo(JValue obj) { diff --git a/Src/Newtonsoft.Json/Schema/JsonSchema.cs b/Src/Newtonsoft.Json/Schema/JsonSchema.cs index 7b322252..68b45dd1 100644 --- a/Src/Newtonsoft.Json/Schema/JsonSchema.cs +++ b/Src/Newtonsoft.Json/Schema/JsonSchema.cs @@ -59,7 +59,7 @@ namespace Newtonsoft.Json.Schema public bool? Required { get; set; } /// - /// Gets or sets whether the object is read only. + /// Gets or sets whether the object is read-only. /// public bool? ReadOnly { get; set; } @@ -103,9 +103,9 @@ namespace Newtonsoft.Json.Schema public int? MaximumLength { get; set; } /// - /// Gets or sets a number that the value should be divisble by. + /// Gets or sets a number that the value should be divisible by. /// - /// A number that the value should be divisble by. + /// A number that the value should be divisible by. public double? DivisibleBy { get; set; } /// @@ -288,21 +288,21 @@ namespace Newtonsoft.Json.Schema } /// - /// Load a from a string that contains schema JSON. + /// Load a from a string that contains JSON Schema. /// - /// A that contains JSON. - /// A populated from the string that contains JSON. + /// A that contains JSON Schema. + /// A populated from the string that contains JSON Schema. public static JsonSchema Parse(string json) { return Parse(json, new JsonSchemaResolver()); } /// - /// Parses the specified json. + /// Load a from a string that contains JSON Schema using the specified . /// - /// The json. + /// A that contains JSON Schema. /// The resolver. - /// A populated from the string that contains JSON. + /// A populated from the string that contains JSON Schema. public static JsonSchema Parse(string json, JsonSchemaResolver resolver) { ValidationUtils.ArgumentNotNull(json, nameof(json)); diff --git a/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs b/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs index f9503dbd..66e4748d 100644 --- a/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs +++ b/Src/Newtonsoft.Json/Schema/JsonSchemaException.cs @@ -94,8 +94,8 @@ namespace Newtonsoft.Json.Schema /// /// The that holds the serialized object data about the exception being thrown. /// The that contains contextual information about the source or destination. - /// The parameter is null. - /// The class name is null or is zero (0). + /// The parameter is null. + /// The class name is null or is zero (0). public JsonSchemaException(SerializationInfo info, StreamingContext context) : base(info, context) { diff --git a/Src/Newtonsoft.Json/Serialization/JsonContract.cs b/Src/Newtonsoft.Json/Serialization/JsonContract.cs index 6d0b2c37..4614f369 100644 --- a/Src/Newtonsoft.Json/Serialization/JsonContract.cs +++ b/Src/Newtonsoft.Json/Serialization/JsonContract.cs @@ -302,7 +302,7 @@ namespace Newtonsoft.Json.Serialization public Func DefaultCreator { get; set; } /// - /// Gets or sets a value indicating whether the default creator is non public. + /// Gets or sets a value indicating whether the default creator is non-public. /// /// true if the default object creator is non-public; otherwise, false. public bool DefaultCreatorNonPublic { get; set; } diff --git a/Src/Newtonsoft.Json/Serialization/JsonProperty.cs b/Src/Newtonsoft.Json/Serialization/JsonProperty.cs index 9b0ab584..720830a4 100644 --- a/Src/Newtonsoft.Json/Serialization/JsonProperty.cs +++ b/Src/Newtonsoft.Json/Serialization/JsonProperty.cs @@ -235,9 +235,9 @@ namespace Newtonsoft.Json.Serialization public TypeNameHandling? TypeNameHandling { get; set; } /// - /// Gets or sets a predicate used to determine whether the property should be serialize. + /// Gets or sets a predicate used to determine whether the property should be serialized. /// - /// A predicate used to determine whether the property should be serialize. + /// A predicate used to determine whether the property should be serialized. public Predicate ShouldSerialize { get; set; } /// diff --git a/Src/Newtonsoft.Json/Utilities/LinqBridge.cs b/Src/Newtonsoft.Json/Utilities/LinqBridge.cs index f1a08073..f24636f8 100644 --- a/Src/Newtonsoft.Json/Utilities/LinqBridge.cs +++ b/Src/Newtonsoft.Json/Utilities/LinqBridge.cs @@ -724,7 +724,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Returns an that represents the total number + /// Returns a that represents the total number /// of elements in a sequence. /// @@ -740,7 +740,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Returns an that represents how many elements + /// Returns a that represents how many elements /// in a sequence satisfy a condition. /// @@ -1777,7 +1777,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge internal partial class Enumerable { /// - /// Computes the sum of a sequence of nullable values. + /// Computes the sum of a sequence of values. /// public static int Sum( @@ -1793,7 +1793,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable + /// Computes the sum of a sequence of /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -1806,7 +1806,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values. + /// Computes the average of a sequence of values. /// public static double Average( @@ -1831,7 +1831,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values + /// Computes the average of a sequence of values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -1845,7 +1845,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge /// - /// Computes the sum of a sequence of values. + /// Computes the sum of a sequence of nullable values. /// public static int? Sum( @@ -1861,7 +1861,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of + /// Computes the sum of a sequence of nullable /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -1874,7 +1874,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values. + /// Computes the average of a sequence of nullable values. /// public static double? Average( @@ -1899,7 +1899,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values + /// Computes the average of a sequence of nullable values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -1963,7 +1963,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable values. + /// Computes the sum of a sequence of values. /// public static long Sum( @@ -1979,7 +1979,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable + /// Computes the sum of a sequence of /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -1992,7 +1992,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values. + /// Computes the average of a sequence of values. /// public static double Average( @@ -2017,7 +2017,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values + /// Computes the average of a sequence of values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -2031,7 +2031,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge /// - /// Computes the sum of a sequence of values. + /// Computes the sum of a sequence of nullable values. /// public static long? Sum( @@ -2047,7 +2047,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of + /// Computes the sum of a sequence of nullable /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -2060,7 +2060,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values. + /// Computes the average of a sequence of nullable values. /// public static double? Average( @@ -2085,7 +2085,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values + /// Computes the average of a sequence of nullable values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -2165,7 +2165,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable + /// Computes the sum of a sequence of /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -2178,7 +2178,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values. + /// Computes the average of a sequence of values. /// public static float Average( @@ -2203,7 +2203,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values + /// Computes the average of a sequence of values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -2217,7 +2217,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge /// - /// Computes the sum of a sequence of values. + /// Computes the sum of a sequence of nullable values. /// public static float? Sum( @@ -2233,7 +2233,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of + /// Computes the sum of a sequence of nullable /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -2246,7 +2246,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values. + /// Computes the average of a sequence of nullable values. /// public static float? Average( @@ -2271,7 +2271,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values + /// Computes the average of a sequence of nullable values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -2335,7 +2335,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable values. + /// Computes the sum of a sequence of values. /// public static double Sum( @@ -2351,7 +2351,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable + /// Computes the sum of a sequence of /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -2364,7 +2364,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values. + /// Computes the average of a sequence of values. /// public static double Average( @@ -2389,7 +2389,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values + /// Computes the average of a sequence of values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -2403,7 +2403,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge /// - /// Computes the sum of a sequence of values. + /// Computes the sum of a sequence of nullable values. /// public static double? Sum( @@ -2419,7 +2419,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of + /// Computes the sum of a sequence of nullable /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -2432,7 +2432,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values. + /// Computes the average of a sequence of nullable values. /// public static double? Average( @@ -2457,7 +2457,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values + /// Computes the average of a sequence of nullable values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -2521,7 +2521,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable values. + /// Computes the sum of a sequence of values. /// public static decimal Sum( @@ -2537,7 +2537,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of nullable + /// Computes the sum of a sequence of /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -2550,7 +2550,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values. + /// Computes the average of a sequence of values. /// public static decimal Average( @@ -2575,7 +2575,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of nullable values + /// Computes the average of a sequence of values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// @@ -2589,7 +2589,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge /// - /// Computes the sum of a sequence of values. + /// Computes the sum of a sequence of nullable values. /// public static decimal? Sum( @@ -2605,7 +2605,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the sum of a sequence of + /// Computes the sum of a sequence of nullable /// values that are obtained by invoking a transform function on /// each element of the input sequence. /// @@ -2618,7 +2618,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values. + /// Computes the average of a sequence of nullable values. /// public static decimal? Average( @@ -2643,7 +2643,7 @@ namespace Newtonsoft.Json.Utilities.LinqBridge } /// - /// Computes the average of a sequence of values + /// Computes the average of a sequence of nullable values /// that are obtained by invoking a transform function on each /// element of the input sequence. /// diff --git a/Src/Newtonsoft.Json/Utilities/MethodBinder.cs b/Src/Newtonsoft.Json/Utilities/MethodBinder.cs index 396f5af4..ee9af05e 100644 --- a/Src/Newtonsoft.Json/Utilities/MethodBinder.cs +++ b/Src/Newtonsoft.Json/Utilities/MethodBinder.cs @@ -39,9 +39,9 @@ /// Checks if value of primitive type can be /// assigned to parameter of primitive type . /// - /// Source primitive type - /// Target primitive type - /// True if source type can be widened to target type, false otherwise + /// Source primitive type. + /// Target primitive type. + /// True if source type can be widened to target type, false otherwise. private static bool CanConvertPrimitive(Type from, Type to) { if (from == to) @@ -77,10 +77,10 @@ /// Checks if a set of values with given can be used /// to invoke a method with specified . /// - /// Method parameters - /// Argument types - /// Try to pack extra arguments into ParamArray - /// True if method can be called with given arguments, false otherwise + /// Method parameters. + /// Argument types. + /// Try to pack extra arguments into ParamArray. + /// True if method can be called with given arguments, false otherwise. private static bool FilterParameters(ParameterInfo[] parameters, IList types, bool enableParamArray) { ValidationUtils.ArgumentNotNull(parameters, nameof(parameters)); @@ -293,11 +293,11 @@ } /// - /// Retunrs a best method overload for given argument . + /// Returns a best method overload for given argument . /// - /// List of method candidates - /// Argument types - /// Best method overload, or null if none matched + /// List of method candidates. + /// Argument types. + /// Best method overload, or null if none matched. public static TMethod SelectMethod(IEnumerable candidates, IList types) where TMethod : MethodBase { ValidationUtils.ArgumentNotNull(candidates, nameof(candidates));