From 6b2f05154aadb53d7cf312439f27314cc0aa49d2 Mon Sep 17 00:00:00 2001 From: Dan Moseley Date: Mon, 9 Aug 2021 12:58:01 -0600 Subject: [PATCH] More JSON xml updates (#57022) --- .../Common/JsonKnownNamingPolicy.cs | 2 +- .../Common/JsonSourceGenerationOptionsAttribute.cs | 4 +-- .../Text/Json/Document/JsonDocument.Parse.cs | 10 +++--- .../System/Text/Json/Document/JsonElement.Parse.cs | 6 ++-- .../src/System/Text/Json/Nodes/JsonNode.Parse.cs | 6 ++-- .../Text/Json/Reader/Utf8JsonReader.TryGet.cs | 2 +- .../Json/Serialization/JsonSerializer.Read.Span.cs | 16 ++++----- .../Serialization/JsonSerializer.Read.Stream.cs | 42 +++++++++++----------- .../Serialization/JsonSerializer.Read.String.cs | 14 ++++---- .../JsonSerializer.Read.Utf8JsonReader.cs | 24 ++++++------- .../JsonSerializer.Write.ByteArray.cs | 8 ++--- .../Serialization/JsonSerializer.Write.Document.cs | 8 ++--- .../Serialization/JsonSerializer.Write.Element.cs | 8 ++--- .../Serialization/JsonSerializer.Write.Node.cs | 8 ++--- .../Serialization/JsonSerializer.Write.Stream.cs | 28 +++++++-------- .../Serialization/JsonSerializer.Write.String.cs | 8 ++--- .../JsonSerializer.Write.Utf8JsonWriter.cs | 8 ++--- .../Json/Serialization/JsonSerializerContext.cs | 10 +++--- .../Serialization/Metadata/JsonParameterInfo.cs | 2 +- 19 files changed, 107 insertions(+), 107 deletions(-) diff --git a/src/libraries/System.Text.Json/Common/JsonKnownNamingPolicy.cs b/src/libraries/System.Text.Json/Common/JsonKnownNamingPolicy.cs index 10a4be3..73868fc 100644 --- a/src/libraries/System.Text.Json/Common/JsonKnownNamingPolicy.cs +++ b/src/libraries/System.Text.Json/Common/JsonKnownNamingPolicy.cs @@ -4,7 +4,7 @@ namespace System.Text.Json.Serialization { /// - /// The to be used at run-time. + /// The to be used at run time. /// #if BUILDING_SOURCE_GENERATOR internal diff --git a/src/libraries/System.Text.Json/Common/JsonSourceGenerationOptionsAttribute.cs b/src/libraries/System.Text.Json/Common/JsonSourceGenerationOptionsAttribute.cs index 6527071..84ffc3d 100644 --- a/src/libraries/System.Text.Json/Common/JsonSourceGenerationOptionsAttribute.cs +++ b/src/libraries/System.Text.Json/Common/JsonSourceGenerationOptionsAttribute.cs @@ -5,7 +5,7 @@ namespace System.Text.Json.Serialization { /// /// Instructs the System.Text.Json source generator to assume the specified - /// options will be used at run-time via . + /// options will be used at run time via . /// [AttributeUsage(AttributeTargets.Class, AllowMultiple = false)] #if BUILDING_SOURCE_GENERATOR @@ -31,7 +31,7 @@ namespace System.Text.Json.Serialization public bool IgnoreReadOnlyProperties { get; set; } /// - /// Specifies whether to ignore custom converters provided at run-time. + /// Specifies whether to ignore custom converters provided at run time. /// public bool IgnoreRuntimeCustomConverters { get; set; } diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonDocument.Parse.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonDocument.Parse.cs index c287240..0e74466 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonDocument.Parse.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonDocument.Parse.cs @@ -229,7 +229,7 @@ namespace System.Text.Json } /// - /// Parse text representing a single JSON value into a JsonDocument. + /// Parses text representing a single JSON value into a JsonDocument. /// /// /// The value may be used for the entire lifetime of the @@ -298,7 +298,7 @@ namespace System.Text.Json } /// - /// Parse text representing a single JSON value into a JsonDocument. + /// Parses text representing a single JSON value into a JsonDocument. /// /// JSON text to parse. /// Options to control the reader behavior during parsing. @@ -340,7 +340,7 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the + /// Upon completion of this method, will be positioned at the /// final token in the JSON value. If an exception is thrown, or /// is returned, the reader is reset to the state it was in when the method was called. /// @@ -380,8 +380,8 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the - /// final token in the JSON value. If an exception is thrown the reader is reset to + /// Upon completion of this method, will be positioned at the + /// final token in the JSON value. If an exception is thrown, the reader is reset to /// the state it was in when the method was called. /// /// diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonElement.Parse.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonElement.Parse.cs index d96fdc4..243fe7f 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonElement.Parse.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Document/JsonElement.Parse.cs @@ -25,8 +25,8 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the - /// final token in the JSON value. If an exception is thrown the reader is reset to + /// Upon completion of this method, will be positioned at the + /// final token in the JSON value. If an exception is thrown, the reader is reset to /// the state it was in when the method was called. /// /// @@ -90,7 +90,7 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the + /// Upon completion of this method, will be positioned at the /// final token in the JSON value. If an exception is thrown, or /// is returned, the reader is reset to the state it was in when the method was called. /// diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Nodes/JsonNode.Parse.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Nodes/JsonNode.Parse.cs index 4985831..e59eedb 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Nodes/JsonNode.Parse.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Nodes/JsonNode.Parse.cs @@ -24,7 +24,7 @@ namespace System.Text.Json.Nodes /// the start of the value. /// /// - /// Upon completion of this method will be positioned at the + /// Upon completion of this method, will be positioned at the /// final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called. /// /// @@ -50,7 +50,7 @@ namespace System.Text.Json.Nodes } /// - /// Parse text representing a single JSON value. + /// Parses text representing a single JSON value. /// /// JSON text to parse. /// Options to control the node behavior after parsing. @@ -79,7 +79,7 @@ namespace System.Text.Json.Nodes } /// - /// Parse text representing a single JSON value. + /// Parses text representing a single JSON value. /// /// JSON text to parse. /// Options to control the node behavior after parsing. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Reader/Utf8JsonReader.TryGet.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Reader/Utf8JsonReader.TryGet.cs index 0af169f..b65653e 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Reader/Utf8JsonReader.TryGet.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Reader/Utf8JsonReader.TryGet.cs @@ -102,7 +102,7 @@ namespace System.Text.Json /// /// /// - /// Thrown when the JSON string contains data outside of the expected Base64 range, or if it contains invalid/more than two padding characters, + /// The JSON string contains data outside of the expected Base64 range, or if it contains invalid/more than two padding characters, /// or is incomplete (i.e. the JSON string length is not a multiple of 4). /// public byte[] GetBytesFromBase64() diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Span.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Span.cs index 7200b54..6983253 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Span.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Span.cs @@ -10,13 +10,13 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Parse the UTF-8 encoded text representing a single JSON value into a . + /// Parses the UTF-8 encoded text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. /// Options to control the behavior during parsing. /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -29,7 +29,7 @@ namespace System.Text.Json => ReadUsingOptions(utf8Json, typeof(TValue), options); /// - /// Parse the UTF-8 encoded text representing a single JSON value into a . + /// Parses the UTF-8 encoded text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. @@ -39,7 +39,7 @@ namespace System.Text.Json /// is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -59,13 +59,13 @@ namespace System.Text.Json } /// - /// Parse the UTF-8 encoded text representing a single JSON value into a . + /// Parses the UTF-8 encoded text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. /// Metadata about the type to convert. /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -84,7 +84,7 @@ namespace System.Text.Json } /// - /// Parse the UTF-8 encoded text representing a single JSON value into a . + /// Parses the UTF-8 encoded text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. @@ -94,7 +94,7 @@ namespace System.Text.Json /// is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Stream.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Stream.cs index d84191e..95c26c4 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Stream.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Stream.cs @@ -18,20 +18,20 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. /// JSON data to parse. /// Options to control the behavior during reading. /// - /// The which may be used to cancel the read operation. + /// The that can be used to cancel the read operation. /// /// /// is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -54,7 +54,7 @@ namespace System.Text.Json } /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. @@ -64,7 +64,7 @@ namespace System.Text.Json /// is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -86,7 +86,7 @@ namespace System.Text.Json } /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. @@ -94,13 +94,13 @@ namespace System.Text.Json /// The type of the object to convert to and return. /// Options to control the behavior during reading. /// - /// The which may be used to cancel the read operation. + /// The that can be used to cancel the read operation. /// /// /// or is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// the is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -129,7 +129,7 @@ namespace System.Text.Json } /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. @@ -140,7 +140,7 @@ namespace System.Text.Json /// or is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// the is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -168,20 +168,20 @@ namespace System.Text.Json } /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. /// JSON data to parse. /// Metadata about the type to convert. /// - /// The which may be used to cancel the read operation. + /// The that can be used to cancel the read operation. /// /// /// or is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -208,7 +208,7 @@ namespace System.Text.Json } /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. @@ -218,7 +218,7 @@ namespace System.Text.Json /// or is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -244,7 +244,7 @@ namespace System.Text.Json } /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. @@ -252,13 +252,13 @@ namespace System.Text.Json /// The type of the object to convert to and return. /// A metadata provider for serializable types. /// - /// The which may be used to cancel the read operation. + /// The that can be used to cancel the read operation. /// /// /// , , or is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// the is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -295,7 +295,7 @@ namespace System.Text.Json } /// - /// Read the UTF-8 encoded text representing a single JSON value into a . + /// Reads the UTF-8 encoded text representing a single JSON value into a . /// The Stream will be read to completion. /// /// A representation of the JSON value. @@ -306,7 +306,7 @@ namespace System.Text.Json /// , , or is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// the is not compatible with the JSON, /// or when there is remaining data in the Stream. /// @@ -348,7 +348,7 @@ namespace System.Text.Json /// An representation of the provided JSON array. /// JSON data to parse. /// Options to control the behavior during reading. - /// The which may be used to cancel the read operation. + /// The that can be used to cancel the read operation. /// An representation of the JSON value. /// /// is . diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.String.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.String.cs index 50add92..b3f07a5 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.String.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.String.cs @@ -15,7 +15,7 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Parse the text representing a single JSON value into a . + /// Parses the text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. @@ -83,7 +83,7 @@ namespace System.Text.Json } /// - /// Parse the text representing a single JSON value into a . + /// Parses the text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. @@ -126,7 +126,7 @@ namespace System.Text.Json } /// - /// Parse the text representing a single JSON value into an instance of a specified type. + /// Parses the text representing a single JSON value into an instance of a specified type. /// /// A representation of the JSON value. /// The JSON text to parse. @@ -166,7 +166,7 @@ namespace System.Text.Json } /// - /// Parse the text representing a single JSON value into a . + /// Parses the text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. @@ -213,7 +213,7 @@ namespace System.Text.Json } /// - /// Parse the text representing a single JSON value into a . + /// Parses the text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. @@ -255,7 +255,7 @@ namespace System.Text.Json } /// - /// Parse the text representing a single JSON value into a . + /// Parses the text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. @@ -300,7 +300,7 @@ namespace System.Text.Json } /// - /// Parse the text representing a single JSON value into a . + /// Parses the text representing a single JSON value into a . /// /// A representation of the JSON value. /// JSON text to parse. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Utf8JsonReader.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Utf8JsonReader.cs index b1cee07..d0d35d4 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Utf8JsonReader.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Read.Utf8JsonReader.cs @@ -18,7 +18,7 @@ namespace System.Text.Json /// The reader to read. /// Options to control the serializer behavior during reading. /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or a value could not be read from the reader. /// @@ -38,8 +38,8 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the - /// final token in the JSON value. If an exception is thrown the reader is reset to + /// Upon completion of this method, will be positioned at the + /// final token in the JSON value. If an exception is thrown, the reader is reset to /// the state it was in when the method was called. /// /// @@ -68,7 +68,7 @@ namespace System.Text.Json /// is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or a value could not be read from the reader. /// @@ -88,8 +88,8 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the - /// final token in the JSON value. If an exception is thrown the reader is reset to + /// Upon completion of this method, will be positioned at the + /// final token in the JSON value. If an exception is thrown, the reader is reset to /// the state it was in when the method was called. /// /// @@ -120,7 +120,7 @@ namespace System.Text.Json /// The reader to read. /// Metadata about the type to convert. /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or a value could not be read from the reader. /// @@ -140,8 +140,8 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the - /// final token in the JSON value. If an exception is thrown the reader is reset to + /// Upon completion of this method, will be positioned at the + /// final token in the JSON value. If an exception is thrown, the reader is reset to /// the state it was in when the method was called. /// /// @@ -176,7 +176,7 @@ namespace System.Text.Json /// or is . /// /// - /// Thrown when the JSON is invalid, + /// The JSON is invalid, /// is not compatible with the JSON, /// or a value could not be read from the reader. /// @@ -200,8 +200,8 @@ namespace System.Text.Json /// /// /// - /// Upon completion of this method will be positioned at the - /// final token in the JSON value. If an exception is thrown the reader is reset to + /// Upon completion of this method, will be positioned at the + /// final token in the JSON value. If an exception is thrown, the reader is reset to /// the state it was in when the method was called. /// /// diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.ByteArray.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.ByteArray.cs index 880ce55..932689c 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.ByteArray.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.ByteArray.cs @@ -10,7 +10,7 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Convert the provided value into a array. + /// Converts the provided value into a array. /// /// A UTF-8 representation of the value. /// The value to convert. @@ -28,7 +28,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a array. + /// Converts the provided value into a array. /// /// A UTF-8 representation of the value. /// The value to convert. @@ -57,7 +57,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a array. + /// Converts the provided value into a array. /// /// A UTF-8 representation of the value. /// The value to convert. @@ -80,7 +80,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a array. + /// Converts the provided value into a array. /// /// A UTF-8 representation of the value. /// The value to convert. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Document.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Document.cs index 1c5d7c7..d96d63e 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Document.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Document.cs @@ -11,7 +11,7 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the JSON value. /// The value to convert. @@ -25,7 +25,7 @@ namespace System.Text.Json WriteDocument(value, GetRuntimeType(value), options); /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -49,7 +49,7 @@ namespace System.Text.Json options); /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -72,7 +72,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Element.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Element.cs index a606fee..0690047 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Element.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Element.cs @@ -11,7 +11,7 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the JSON value. /// The value to convert. @@ -25,7 +25,7 @@ namespace System.Text.Json WriteElement(value, GetRuntimeType(value), options); /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -49,7 +49,7 @@ namespace System.Text.Json options); /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -72,7 +72,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Node.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Node.cs index 28856f0..4b37821 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Node.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Node.cs @@ -12,7 +12,7 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the JSON value. /// The value to convert. @@ -26,7 +26,7 @@ namespace System.Text.Json WriteNode(value, GetRuntimeType(value), options); /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -50,7 +50,7 @@ namespace System.Text.Json options); /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -73,7 +73,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Stream.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Stream.cs index b5acccd..802b930 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Stream.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Stream.cs @@ -22,13 +22,13 @@ namespace System.Text.Json private const float FlushThreshold = .9f; /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// A task that represents the asynchronous write operation. /// The UTF-8 to write to. /// The value to convert. /// Options to control the conversion behavior. - /// The which may be used to cancel the write operation. + /// The that can be used to cancel the write operation. /// /// is . /// @@ -58,7 +58,7 @@ namespace System.Text.Json /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// The UTF-8 to write to. /// The value to convert. @@ -89,14 +89,14 @@ namespace System.Text.Json } /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// A task that represents the asynchronous write operation. /// The UTF-8 to write to. /// The value to convert. /// The type of the to convert. /// Options to control the conversion behavior. - /// The which may be used to cancel the write operation. + /// The that can be used to cancel the write operation. /// /// is not compatible with . /// @@ -129,7 +129,7 @@ namespace System.Text.Json } /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// The UTF-8 to write to. /// The value to convert. @@ -165,13 +165,13 @@ namespace System.Text.Json } /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// A task that represents the asynchronous write operation. /// The UTF-8 to write to. /// The value to convert. /// Metadata about the type to convert. - /// The which may be used to cancel the write operation. + /// The that can be used to cancel the write operation. /// /// is . /// @@ -199,7 +199,7 @@ namespace System.Text.Json } /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// The UTF-8 to write to. /// The value to convert. @@ -230,19 +230,19 @@ namespace System.Text.Json } /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// A task that represents the asynchronous write operation. /// The UTF-8 to write to. /// The value to convert. /// The type of the to convert. /// A metadata provider for serializable types. - /// The which may be used to cancel the write operation. + /// The that can be used to cancel the write operation. /// /// is not compatible with . /// /// - /// , or is . + /// , , or is . /// /// /// There is no compatible @@ -274,7 +274,7 @@ namespace System.Text.Json } /// - /// Convert the provided value to UTF-8 encoded JSON text and write it to the . + /// Converts the provided value to UTF-8 encoded JSON text and write it to the . /// /// The UTF-8 to write to. /// The value to convert. @@ -284,7 +284,7 @@ namespace System.Text.Json /// is not compatible with . /// /// - /// , or is . + /// , , or is . /// /// /// There is no compatible diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.String.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.String.cs index 62d408a..a7c5048 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.String.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.String.cs @@ -10,7 +10,7 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -30,7 +30,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -63,7 +63,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. @@ -85,7 +85,7 @@ namespace System.Text.Json } /// - /// Convert the provided value into a . + /// Converts the provided value into a . /// /// A representation of the value. /// The value to convert. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Utf8JsonWriter.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Utf8JsonWriter.cs index 9a449bd..7641ae4 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Utf8JsonWriter.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializer.Write.Utf8JsonWriter.cs @@ -10,7 +10,7 @@ namespace System.Text.Json public static partial class JsonSerializer { /// - /// Write one JSON value (including objects or arrays) to the provided writer. + /// Writes one JSON value (including objects or arrays) to the provided writer. /// /// The writer to write. /// The value to convert and write. @@ -32,7 +32,7 @@ namespace System.Text.Json } /// - /// Write one JSON value (including objects or arrays) to the provided writer. + /// Writes one JSON value (including objects or arrays) to the provided writer. /// /// /// The value to convert and write. @@ -63,7 +63,7 @@ namespace System.Text.Json } /// - /// Write one JSON value (including objects or arrays) to the provided writer. + /// Writes one JSON value (including objects or arrays) to the provided writer. /// /// The writer to write. /// The value to convert and write. @@ -91,7 +91,7 @@ namespace System.Text.Json } /// - /// Write one JSON value (including objects or arrays) to the provided writer. + /// Writes one JSON value (including objects or arrays) to the provided writer. /// /// /// The value to convert and write. diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializerContext.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializerContext.cs index e953bdf..688fd91 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializerContext.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/JsonSerializerContext.cs @@ -19,7 +19,7 @@ namespace System.Text.Json.Serialization /// /// Indicates whether pre-generated serialization logic for types in the context - /// is compatible with the run-time specified . + /// is compatible with the run time specified . /// internal bool CanUseSerializationLogic { @@ -61,7 +61,7 @@ namespace System.Text.Json.Serialization } /// - /// Gets the run-time specified options of the context. If no options were passed + /// Gets the run time specified options of the context. If no options were passed /// when instanciating the context, then a new instance is bound and returned. /// /// @@ -84,8 +84,8 @@ namespace System.Text.Json.Serialization /// /// Creates an instance of and binds it with the indicated . /// - /// The run-time provided options for the context instance. - /// The default run-time options for the context. It's values are defined at design-time via . + /// The run time provided options for the context instance. + /// The default run time options for the context. Its values are defined at design-time via . /// /// If no instance options are passed, then no options are set until the context is bound using , /// or until is called, where a new options instance is created and bound. @@ -110,7 +110,7 @@ namespace System.Text.Json.Serialization /// Returns a instance representing the given type. /// /// The type to fetch metadata about. - /// Should return null if the context has no metadata for the type. + /// The metadata for the specified type, or if the context has no metadata for the type. public abstract JsonTypeInfo? GetTypeInfo(Type type); } } diff --git a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/Metadata/JsonParameterInfo.cs b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/Metadata/JsonParameterInfo.cs index 38900c9..ae2768a 100644 --- a/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/Metadata/JsonParameterInfo.cs +++ b/src/libraries/System.Text.Json/src/System/Text/Json/Serialization/Metadata/JsonParameterInfo.cs @@ -75,7 +75,7 @@ namespace System.Text.Json.Serialization.Metadata MatchingPropertyCanBeNull = matchingProperty.PropertyTypeCanBeNull; } - // Create a parameter that is ignored at run-time. It uses the same type (typeof(sbyte)) to help + // Create a parameter that is ignored at run time. It uses the same type (typeof(sbyte)) to help // prevent issues with unsupported types and helps ensure we don't accidently (de)serialize it. public static JsonParameterInfo CreateIgnoredParameterPlaceholder(JsonParameterInfoValues parameterInfo, JsonPropertyInfo matchingProperty) { -- 2.7.4