diff --git a/xml/System.Text.Json.Nodes/JsonArray.xml b/xml/System.Text.Json.Nodes/JsonArray.xml index 746efaec449..ade26f6271c 100644 --- a/xml/System.Text.Json.Nodes/JsonArray.xml +++ b/xml/System.Text.Json.Nodes/JsonArray.xml @@ -353,7 +353,7 @@ It is safe to perform multiple concurrent read operations on a Returns an enumerator that iterates through the . - A for the . + An for the . To be added. @@ -391,8 +391,8 @@ It is safe to perform multiple concurrent read operations on a The type of the value to obtain from the . - Returns an enumerator that wraps calls to . - To be added. + Returns an enumerable that wraps calls to . + An enumerable iterating over values of the array. To be added. diff --git a/xml/System.Text.Json.Nodes/JsonNode.xml b/xml/System.Text.Json.Nodes/JsonNode.xml index 12b947f64fc..c0e2b3dd3d8 100644 --- a/xml/System.Text.Json.Nodes/JsonNode.xml +++ b/xml/System.Text.Json.Nodes/JsonNode.xml @@ -14,8 +14,7 @@ System.Object - - + [System.Runtime.CompilerServices.Nullable(0)] @@ -124,7 +123,7 @@ Creates a new instance of the class. All child nodes are recursively cloned. - To be added. + A new cloned instance of the current node. To be added. @@ -2694,13 +2693,15 @@ This method makes a copy of the data the reader acted on, so there is no caller - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The JSON text to parse. + Options to control the node behavior after parsing. + Options to control the document behavior during parsing. + The token to monitor for cancellation requests. + Parses a as UTF-8 encoded data representing a single JSON value into a . The stream will be read to completion. + A to produce a representation of the JSON value. To be added. + + does not represent a valid single JSON value. diff --git a/xml/System.Text.Json.Serialization/BinaryDataJsonConverter.xml b/xml/System.Text.Json.Serialization/BinaryDataJsonConverter.xml index fc51eef6ec5..ab2216ed2e4 100644 --- a/xml/System.Text.Json.Serialization/BinaryDataJsonConverter.xml +++ b/xml/System.Text.Json.Serialization/BinaryDataJsonConverter.xml @@ -27,7 +27,7 @@ - To be added. + Serializes instances as Base64 JSON strings. To be added. @@ -81,6 +81,7 @@ To be added. To be added. To be added. + @@ -109,6 +110,7 @@ To be added. To be added. To be added. + diff --git a/xml/System.Text.Json.Serialization/JsonConverterFactory.xml b/xml/System.Text.Json.Serialization/JsonConverterFactory.xml index c9803e75ae8..d4c052b23f8 100644 --- a/xml/System.Text.Json.Serialization/JsonConverterFactory.xml +++ b/xml/System.Text.Json.Serialization/JsonConverterFactory.xml @@ -131,6 +131,7 @@ For more information, see [How to write custom converters for JSON serialization To be added. To be added. To be added. + diff --git a/xml/System.Text.Json.Serialization/JsonConverter`1.xml b/xml/System.Text.Json.Serialization/JsonConverter`1.xml index 7752d075863..bae8c29a320 100644 --- a/xml/System.Text.Json.Serialization/JsonConverter`1.xml +++ b/xml/System.Text.Json.Serialization/JsonConverter`1.xml @@ -248,6 +248,7 @@ This method should be overridden in custom converters of types used in deseriali To be added. To be added. To be added. + diff --git a/xml/System.Text.Json.Serialization/JsonNumberEnumConverter`1.xml b/xml/System.Text.Json.Serialization/JsonNumberEnumConverter`1.xml index 520ab8b0846..f7595ef410f 100644 --- a/xml/System.Text.Json.Serialization/JsonNumberEnumConverter`1.xml +++ b/xml/System.Text.Json.Serialization/JsonNumberEnumConverter`1.xml @@ -1,122 +1,122 @@ - - - - - - - - - System.Text.Json - 8.0.0.0 - - - - - DefaultConstructorConstraint - NotNullableValueTypeConstraint - System.ValueType - - - - - System.Text.Json.Serialization.JsonConverterFactory - - - - The enum type that this converter targets. - Converter to convert enums to and from numeric values. - This is the default converter for enums and can be used to override on individual types or properties. - - - - - - - - - Constructor - - System.Text.Json - 8.0.0.0 - - - - To be added. - To be added. - - - - - - - - - - Method - - System.Text.Json - 8.0.0.0 - - - - [System.Runtime.CompilerServices.NullableContext(1)] - [<System.Runtime.CompilerServices.NullableContext(1)>] - - - - System.Boolean - - - - - - The type of the object to check whether it can be converted by this converter instance. - When overridden in a derived class, determines whether the converter instance can convert the specified object type. - - if the instance can convert the specified object type; otherwise, . - To be added. - - - - - - - - - - - Method - - System.Text.Json - 8.0.0.0 - - - - [System.Runtime.CompilerServices.NullableContext(1)] - [<System.Runtime.CompilerServices.NullableContext(1)>] - - - - System.Text.Json.Serialization.JsonConverter - - - [System.Runtime.CompilerServices.Nullable(2)] - [<System.Runtime.CompilerServices.Nullable(2)>] - - - - - - - - - The type handled by the converter. - The serialization options to use. - Creates a converter for a specified type. - A converter for which is compatible with . - To be added. - - - - - + + + + + + + + + System.Text.Json + 8.0.0.0 + + + + + DefaultConstructorConstraint + NotNullableValueTypeConstraint + System.ValueType + + + + + System.Text.Json.Serialization.JsonConverterFactory + + + + The enum type that this converter targets. + Converter to convert enums to and from numeric values. + This is the default converter for enums and can be used to override on individual types or properties. + + + + + + + + + Constructor + + System.Text.Json + 8.0.0.0 + + + + Initializes a new instance of . + To be added. + + + + + + + + + + Method + + System.Text.Json + 8.0.0.0 + + + + [System.Runtime.CompilerServices.NullableContext(1)] + [<System.Runtime.CompilerServices.NullableContext(1)>] + + + + System.Boolean + + + + + + The type of the object to check whether it can be converted by this converter instance. + When overridden in a derived class, determines whether the converter instance can convert the specified object type. + + if the instance can convert the specified object type; otherwise, . + To be added. + + + + + + + + + + + Method + + System.Text.Json + 8.0.0.0 + + + + [System.Runtime.CompilerServices.NullableContext(1)] + [<System.Runtime.CompilerServices.NullableContext(1)>] + + + + System.Text.Json.Serialization.JsonConverter + + + [System.Runtime.CompilerServices.Nullable(2)] + [<System.Runtime.CompilerServices.Nullable(2)>] + + + + + + + + + The type handled by the converter. + The serialization options to use. + Creates a converter for a specified type. + A converter for which is compatible with . + To be added. + + + + + diff --git a/xml/System.Text.Json.Serialization/JsonObjectCreationHandlingAttribute.xml b/xml/System.Text.Json.Serialization/JsonObjectCreationHandlingAttribute.xml index 2b1d71139b0..c80ae7b1ef2 100644 --- a/xml/System.Text.Json.Serialization/JsonObjectCreationHandlingAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonObjectCreationHandlingAttribute.xml @@ -51,7 +51,7 @@ Value types require a setter to support population. In such cases, deserializati - To be added. + The handling to apply to the current member. Initializes a new instance of . To be added. diff --git a/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml b/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml index c9a93f84e88..7715c1ce230 100644 --- a/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml +++ b/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml @@ -1,151 +1,150 @@ - - - - - - - - - System.Text.Json - 8.0.0.0 - - - - - - [System.Runtime.CompilerServices.Nullable(0)] - [<System.Runtime.CompilerServices.Nullable(0)>] - - - - DefaultConstructorConstraint - NotNullableValueTypeConstraint - System.Enum - System.ValueType - - - - - System.Text.Json.Serialization.JsonConverterFactory - - - - - [System.Runtime.CompilerServices.Nullable(0)] - [<System.Runtime.CompilerServices.Nullable(0)>] - - - [System.Runtime.CompilerServices.NullableContext(1)] - [<System.Runtime.CompilerServices.NullableContext(1)>] - - - - The enum type that this converter targets. - Converter to convert enums to and from strings. - Reading is case insensitive, and writing can be customized via a . - - - - - - - - - Constructor - - System.Text.Json - 8.0.0.0 - - - - Initializes a new instance of with the default naming policy and that allows integer values. - To be added. - - - - - - - - - Constructor - - System.Text.Json - 8.0.0.0 - - - - [System.Runtime.CompilerServices.NullableContext(2)] - [<System.Runtime.CompilerServices.NullableContext(2)>] - - - - - - - - Optional naming policy for writing enum values. - - to allow undefined enum values. When , if an enum value isn't defined, it outputs as a number rather than a string. - Initializes a new instance of . - To be added. - - - - - - - - - - Method - - System.Text.Json - 8.0.0.0 - - - System.Boolean - - - - - - The type of the object to check whether it can be converted by this converter instance. - When overridden in a derived class, determines whether the converter instance can convert the specified object type. - - if the instance can convert the specified object type; otherwise, . - To be added. - - - - - - - - - - - Method - - System.Text.Json - 8.0.0.0 - - - System.Text.Json.Serialization.JsonConverter - - - - - - - The type handled by the converter. - The serialization options to use. - Creates a converter for a specified type. - A converter for which is compatible with . - - To be added. - - - - - + + + + + + + + + System.Text.Json + 8.0.0.0 + + + + + + [System.Runtime.CompilerServices.Nullable(0)] + [<System.Runtime.CompilerServices.Nullable(0)>] + + + + DefaultConstructorConstraint + NotNullableValueTypeConstraint + System.Enum + System.ValueType + + + + + System.Text.Json.Serialization.JsonConverterFactory + + + + + [System.Runtime.CompilerServices.Nullable(0)] + [<System.Runtime.CompilerServices.Nullable(0)>] + + + [System.Runtime.CompilerServices.NullableContext(1)] + [<System.Runtime.CompilerServices.NullableContext(1)>] + + + + The enum type that this converter targets. + Converter to convert enums to and from strings. + Reading is case insensitive, and writing can be customized via a . + + + + + + + + + Constructor + + System.Text.Json + 8.0.0.0 + + + + Initializes a new instance of with the default naming policy and that allows integer values. + To be added. + + + + + + + + + Constructor + + System.Text.Json + 8.0.0.0 + + + + [System.Runtime.CompilerServices.NullableContext(2)] + [<System.Runtime.CompilerServices.NullableContext(2)>] + + + + + + + + Optional naming policy for writing enum values. + + to allow undefined enum values. When , if an enum value isn't defined, it outputs as a number rather than a string. + Initializes a new instance of . + To be added. + + + + + + + + + + Method + + System.Text.Json + 8.0.0.0 + + + System.Boolean + + + + + + The type of the object to check whether it can be converted by this converter instance. + When overridden in a derived class, determines whether the converter instance can convert the specified object type. + + if the instance can convert the specified object type; otherwise, . + To be added. + + + + + + + + + + + Method + + System.Text.Json + 8.0.0.0 + + + System.Text.Json.Serialization.JsonConverter + + + + + + + The type handled by the converter. + The serialization options to use. + Creates a converter for a specified type. + A converter for which is compatible with . + To be added. + + + + + diff --git a/xml/System.Text.Json.Serialization/JsonUnmappedMemberHandlingAttribute.xml b/xml/System.Text.Json.Serialization/JsonUnmappedMemberHandlingAttribute.xml index bd8e0ede06b..c30e0c8aaa3 100644 --- a/xml/System.Text.Json.Serialization/JsonUnmappedMemberHandlingAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonUnmappedMemberHandlingAttribute.xml @@ -40,7 +40,7 @@ - To be added. + The handling to apply to the current member. Initializes a new instance of . To be added. diff --git a/xml/System.Text.Json/JsonSerializer.xml b/xml/System.Text.Json/JsonSerializer.xml index d44a6241a7f..1f349dc2b21 100644 --- a/xml/System.Text.Json/JsonSerializer.xml +++ b/xml/System.Text.Json/JsonSerializer.xml @@ -268,7 +268,7 @@ There is remaining data in the string beyond a single JSON value. The to convert. Metadata about the type to convert. Converts the representing a single JSON value into an instance specified by the . - To be added. + A representation of the JSON value. To be added. is . diff --git a/xml/System.Text.Json/JsonSerializerOptions.xml b/xml/System.Text.Json/JsonSerializerOptions.xml index 32d7a586fe4..dd8ea059e77 100644 --- a/xml/System.Text.Json/JsonSerializerOptions.xml +++ b/xml/System.Text.Json/JsonSerializerOptions.xml @@ -782,9 +782,16 @@ For more information, see [How to ignore properties with System.Text.Json](/dotn - To be added. - To be added. - To be added. + Populates unconfigured properties with the reflection-based default. + Marks the current instance as read-only preventing any further user modification. + When is set to , configures the instance following the semantics of the methods accepting parameters. + + This method is idempotent. + + The instance does not specify a setting. Thrown when is . + -or- + The feature switch has been turned off. +