From 4d3efecb63c1eaa7d14ffd8fb0ed8167fde584a0 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Fri, 26 Jun 2026 15:43:07 -0700 Subject: [PATCH 1/5] add MemberGroup descriptions --- xml/System.Text.Encodings.Web/HtmlEncoder.xml | 5 + .../JavaScriptEncoder.xml | 5 + xml/System.Text.Encodings.Web/TextEncoder.xml | 5 + .../TextEncoderSettings.xml | 5 + xml/System.Text.Encodings.Web/UrlEncoder.xml | 5 + xml/System.Text.Json.Nodes/JsonArray.xml | 5 + xml/System.Text.Json.Nodes/JsonNode.xml | 15 + xml/System.Text.Json.Nodes/JsonObject.xml | 25 + xml/System.Text.Json.Nodes/JsonValue.xml | 10 + .../JsonSchemaExporter.xml | 5 + .../JsonDerivedType.xml | 5 + .../JsonMetadataServices.xml | 5 + .../JsonTypeInfoResolver.xml | 5 + .../JsonConverterAttribute.xml | 5 + .../JsonDerivedTypeAttribute.xml | 5 + .../JsonNamingPolicyAttribute.xml | 5 + .../JsonSourceGenerationOptionsAttribute.xml | 5 + .../JsonStringEnumConverter.xml | 5 + .../JsonStringEnumConverter`1.xml | 5 + xml/System.Text.Json/JsonDocument.xml | 5 + xml/System.Text.Json/JsonElement.xml | 20 + xml/System.Text.Json/JsonEncodedText.xml | 10 + xml/System.Text.Json/JsonException.xml | 5 + xml/System.Text.Json/JsonProperty.xml | 5 + xml/System.Text.Json/JsonSerializer.xml | 87 +++ .../JsonSerializerOptions.xml | 10 + xml/System.Text.Json/Utf8JsonReader.xml | 15 + xml/System.Text.Json/Utf8JsonWriter.xml | 75 +++ .../CaptureCollection.xml | 5 + .../GeneratedRegexAttribute.xml | 5 + .../GroupCollection.xml | 5 + .../MatchCollection.xml | 5 + xml/System.Text.RegularExpressions/Regex.xml | 15 + ...Utf8+TryWriteInterpolatedStringHandler.xml | 15 + xml/System.Text.Unicode/Utf8.xml | 617 +++++++++--------- xml/System.Text/Ascii.xml | 50 ++ xml/System.Text/CodePagesEncodingProvider.xml | 2 +- xml/System.Text/EncodingExtensions.xml | 15 + .../RedactionStringBuilderExtensions.xml | 5 + xml/System.Text/Rune.xml | 25 + ...uilder+AppendInterpolatedStringHandler.xml | 15 + xml/System.Text/StringBuilder.xml | 20 + xml/System.Threading.Channels/Channel.xml | 15 + .../ChannelClosedException.xml | 5 + xml/System.Threading.Channels/Channel`2.xml | 5 + .../PartitionedRateLimiter`1.xml | 5 + .../RateLimitLease.xml | 5 + .../RateLimiter.xml | 5 + .../ActionBlock`1.xml | 5 + .../BatchBlock`1.xml | 5 + .../BatchedJoinBlock`2.xml | 5 + .../BatchedJoinBlock`3.xml | 5 + .../BroadcastBlock`1.xml | 5 + .../BufferBlock`1.xml | 5 + .../DataflowBlock.xml | 35 + .../DataflowMessageHeader.xml | 5 + .../JoinBlock`2.xml | 5 + .../JoinBlock`3.xml | 5 + .../TransformBlock`2.xml | 5 + .../TransformManyBlock`2.xml | 5 + .../WriteOnceBlock`1.xml | 5 + xml/System.Threading.Tasks/Parallel.xml | 20 + xml/System.Threading.Tasks/Task.xml | 35 + .../TaskCompletionSource.xml | 25 + .../TaskCompletionSource`1.xml | 5 + xml/System.Threading.Tasks/TaskFactory.xml | 70 ++ xml/System.Threading.Tasks/TaskFactory`1.xml | 25 + xml/System.Threading.Tasks/Task`1.xml | 15 + xml/System.Threading.Tasks/ValueTask.xml | 10 + xml/System.Threading.Tasks/ValueTask`1.xml | 10 + xml/System.Threading/CancellationToken.xml | 5 + xml/System.Threading/Interlocked.xml | 15 + xml/System.Threading/Lock.xml | 5 + xml/System.Threading/PeriodicTimer.xml | 5 + xml/System.Threading/SpinWait.xml | 5 + xml/System.Threading/Thread.xml | 5 + xml/System.Threading/ThreadPool.xml | 5 + .../ThreadingAclExtensions.xml | 10 + .../TransactionOptions.xml | 5 + 79 files changed, 1264 insertions(+), 307 deletions(-) diff --git a/xml/System.Text.Encodings.Web/HtmlEncoder.xml b/xml/System.Text.Encodings.Web/HtmlEncoder.xml index 9975ac8b5bd..b9c7db08363 100644 --- a/xml/System.Text.Encodings.Web/HtmlEncoder.xml +++ b/xml/System.Text.Encodings.Web/HtmlEncoder.xml @@ -71,6 +71,11 @@ + + + Creates a new instance of the HtmlEncoder class with the specified settings. + + diff --git a/xml/System.Text.Encodings.Web/JavaScriptEncoder.xml b/xml/System.Text.Encodings.Web/JavaScriptEncoder.xml index 25efb21a1f0..5410b35fd5b 100644 --- a/xml/System.Text.Encodings.Web/JavaScriptEncoder.xml +++ b/xml/System.Text.Encodings.Web/JavaScriptEncoder.xml @@ -70,6 +70,11 @@ To be added. + + + Creates a new instance of JavaScriptEncoder class with the specified settings. + + diff --git a/xml/System.Text.Encodings.Web/TextEncoder.xml b/xml/System.Text.Encodings.Web/TextEncoder.xml index 8cf4984f278..73606518e5b 100644 --- a/xml/System.Text.Encodings.Web/TextEncoder.xml +++ b/xml/System.Text.Encodings.Web/TextEncoder.xml @@ -66,6 +66,11 @@ To be added. + + + Encodes the supplied characters. + + diff --git a/xml/System.Text.Encodings.Web/TextEncoderSettings.xml b/xml/System.Text.Encodings.Web/TextEncoderSettings.xml index 4b39dbc5bc4..f491a7c456f 100644 --- a/xml/System.Text.Encodings.Web/TextEncoderSettings.xml +++ b/xml/System.Text.Encodings.Web/TextEncoderSettings.xml @@ -43,6 +43,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Encodings.Web/UrlEncoder.xml b/xml/System.Text.Encodings.Web/UrlEncoder.xml index 777566ccd31..d636f184bbb 100644 --- a/xml/System.Text.Encodings.Web/UrlEncoder.xml +++ b/xml/System.Text.Encodings.Web/UrlEncoder.xml @@ -71,6 +71,11 @@ + + + Creates a new instance of UrlEncoder class with the specified settings. + + diff --git a/xml/System.Text.Json.Nodes/JsonArray.xml b/xml/System.Text.Json.Nodes/JsonArray.xml index 5a6488d59a0..e87487f3628 100644 --- a/xml/System.Text.Json.Nodes/JsonArray.xml +++ b/xml/System.Text.Json.Nodes/JsonArray.xml @@ -67,6 +67,11 @@ It is safe to perform multiple concurrent read operations on a + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json.Nodes/JsonNode.xml b/xml/System.Text.Json.Nodes/JsonNode.xml index 973a1bf0609..c88bb31b0a9 100644 --- a/xml/System.Text.Json.Nodes/JsonNode.xml +++ b/xml/System.Text.Json.Nodes/JsonNode.xml @@ -409,6 +409,11 @@ The underlying value of a after deserial The current is not a . + + + Defines an explicit conversion of a given to a . + + @@ -1447,6 +1452,11 @@ The underlying value of a after deserial To be added. + + + Defines an implicit conversion of a given to a . + + @@ -2551,6 +2561,11 @@ The underlying value of a after deserial To be added. + + + Parses text representing a single JSON value. + + diff --git a/xml/System.Text.Json.Nodes/JsonObject.xml b/xml/System.Text.Json.Nodes/JsonObject.xml index 17170dc17ed..636895f8e0c 100644 --- a/xml/System.Text.Json.Nodes/JsonObject.xml +++ b/xml/System.Text.Json.Nodes/JsonObject.xml @@ -81,6 +81,11 @@ It's safe to perform multiple concurrent read operations on a + + + Initializes a new instance of the class. + + @@ -140,6 +145,11 @@ It's safe to perform multiple concurrent read operations on a To be added. + + + Adds the specified property to the . + + @@ -559,6 +569,11 @@ It's safe to perform multiple concurrent read operations on a is less than 0 or greater than or equal to . + + + Sets a new property at the specified index. + + @@ -1034,6 +1049,11 @@ This member is an explicit interface member implementation. It can be used only + + + Adds an element with the provided name and value to the , if a property named doesn't already exist. + + @@ -1112,6 +1132,11 @@ This member is an explicit interface member implementation. It can be used only is . + + + Returns the value of a property with the specified name. + + diff --git a/xml/System.Text.Json.Nodes/JsonValue.xml b/xml/System.Text.Json.Nodes/JsonValue.xml index 13f3ff98d94..155d150aafd 100644 --- a/xml/System.Text.Json.Nodes/JsonValue.xml +++ b/xml/System.Text.Json.Nodes/JsonValue.xml @@ -31,6 +31,11 @@ To be added. + + + Initializes a new instance of the class that contains the specified value. + + @@ -1170,6 +1175,11 @@ To be added. + + + Initializes a new instance of the class that contains the specified value. + + diff --git a/xml/System.Text.Json.Schema/JsonSchemaExporter.xml b/xml/System.Text.Json.Schema/JsonSchemaExporter.xml index 91cf781dd01..6920784057b 100644 --- a/xml/System.Text.Json.Schema/JsonSchemaExporter.xml +++ b/xml/System.Text.Json.Schema/JsonSchemaExporter.xml @@ -30,6 +30,11 @@ To be added. + + + Generates a JSON schema corresponding to the specified contract metadata. + + diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonDerivedType.xml b/xml/System.Text.Json.Serialization.Metadata/JsonDerivedType.xml index 2881432748b..304360df1a8 100644 --- a/xml/System.Text.Json.Serialization.Metadata/JsonDerivedType.xml +++ b/xml/System.Text.Json.Serialization.Metadata/JsonDerivedType.xml @@ -34,6 +34,11 @@ To be added. + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml index d083503c553..ed872d19cc2 100644 --- a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml +++ b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml @@ -2017,6 +2017,11 @@ This API is for use by the output of the System.Text.Json source generator and s + + + Creates a instance that converts values. + + diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml index 6a52da5bb59..a0ab529126f 100644 --- a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml +++ b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml @@ -31,6 +31,11 @@ To be added. + + + Combines multiple sources into one. + + diff --git a/xml/System.Text.Json.Serialization/JsonConverterAttribute.xml b/xml/System.Text.Json.Serialization/JsonConverterAttribute.xml index 6d7337c85e8..a6a447b23f3 100644 --- a/xml/System.Text.Json.Serialization/JsonConverterAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonConverterAttribute.xml @@ -60,6 +60,11 @@ For more information, see [How to write custom converters for JSON serialization + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json.Serialization/JsonDerivedTypeAttribute.xml b/xml/System.Text.Json.Serialization/JsonDerivedTypeAttribute.xml index 463f3bbf1c2..1cb3d6a2431 100644 --- a/xml/System.Text.Json.Serialization/JsonDerivedTypeAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonDerivedTypeAttribute.xml @@ -34,6 +34,11 @@ To be added. + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json.Serialization/JsonNamingPolicyAttribute.xml b/xml/System.Text.Json.Serialization/JsonNamingPolicyAttribute.xml index 3ce80d441f1..dbb818bed8a 100644 --- a/xml/System.Text.Json.Serialization/JsonNamingPolicyAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonNamingPolicyAttribute.xml @@ -28,6 +28,11 @@ To be added. + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json.Serialization/JsonSourceGenerationOptionsAttribute.xml b/xml/System.Text.Json.Serialization/JsonSourceGenerationOptionsAttribute.xml index 9828c5c365e..13c6dca0e7e 100644 --- a/xml/System.Text.Json.Serialization/JsonSourceGenerationOptionsAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonSourceGenerationOptionsAttribute.xml @@ -35,6 +35,11 @@ To be added. + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json.Serialization/JsonStringEnumConverter.xml b/xml/System.Text.Json.Serialization/JsonStringEnumConverter.xml index 8920f6f9f87..6a7d078b415 100644 --- a/xml/System.Text.Json.Serialization/JsonStringEnumConverter.xml +++ b/xml/System.Text.Json.Serialization/JsonStringEnumConverter.xml @@ -56,6 +56,11 @@ For more information, see [How to customize property names and values with Syste + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml b/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml index 626e0956371..dd05198b595 100644 --- a/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml +++ b/xml/System.Text.Json.Serialization/JsonStringEnumConverter`1.xml @@ -46,6 +46,11 @@ Reading is case insensitive, and writing can be customized via a . + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json/JsonDocument.xml b/xml/System.Text.Json/JsonDocument.xml index fc324661842..64c683162d3 100644 --- a/xml/System.Text.Json/JsonDocument.xml +++ b/xml/System.Text.Json/JsonDocument.xml @@ -73,6 +73,11 @@ For more information, see [How to use the JSON DOM, Utf8JsonReader, and Utf8Json + + + Parses text representing a single JSON value into a JsonDocument. + + diff --git a/xml/System.Text.Json/JsonElement.xml b/xml/System.Text.Json/JsonElement.xml index 903d5f2b04b..ae48116207d 100644 --- a/xml/System.Text.Json/JsonElement.xml +++ b/xml/System.Text.Json/JsonElement.xml @@ -677,6 +677,11 @@ This method does not parse the contents of a JSON string value. The parent has been disposed. + + + Gets a representing the value of a required property identified by . + + @@ -1183,6 +1188,11 @@ This method does not parse the contents of a JSON string value. The parent has been disposed. + + + Parses text representing a single JSON value into a . + + @@ -1842,6 +1852,11 @@ This method does not parse the contents of a JSON string value. The parent has been disposed. + + + Looks for a property named in the current object, returning a value that indicates whether or not such a property exists. When the property exists, its value is assigned to the argument. + + @@ -2294,6 +2309,11 @@ This method makes a copy of the data the reader acted on, so there is no caller A value could not be read from the reader. + + + Compares a specified string to the string value of this element. + + diff --git a/xml/System.Text.Json/JsonEncodedText.xml b/xml/System.Text.Json/JsonEncodedText.xml index d1176b6fd54..4172e7ecbac 100644 --- a/xml/System.Text.Json/JsonEncodedText.xml +++ b/xml/System.Text.Json/JsonEncodedText.xml @@ -46,6 +46,11 @@ This type can be used to cache and store known strings used for writing JSON ahe + + + Encodes a UTF-8 text value as a JSON string. + + @@ -221,6 +226,11 @@ This type can be used to cache and store known strings used for writing JSON ahe To be added. + + + Determines whether this instance and another specified instance have the same value. + + diff --git a/xml/System.Text.Json/JsonException.xml b/xml/System.Text.Json/JsonException.xml index 3664eaa3d0f..4950676ba90 100644 --- a/xml/System.Text.Json/JsonException.xml +++ b/xml/System.Text.Json/JsonException.xml @@ -47,6 +47,11 @@ For more information, see [How to write custom converters for JSON serialization + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.Json/JsonProperty.xml b/xml/System.Text.Json/JsonProperty.xml index 3089c0afd2c..26da4778084 100644 --- a/xml/System.Text.Json/JsonProperty.xml +++ b/xml/System.Text.Json/JsonProperty.xml @@ -71,6 +71,11 @@ To be added. + + + Compares the specified string to the name of this property. + + diff --git a/xml/System.Text.Json/JsonSerializer.xml b/xml/System.Text.Json/JsonSerializer.xml index 9903f432996..d86a0a5f9f5 100644 --- a/xml/System.Text.Json/JsonSerializer.xml +++ b/xml/System.Text.Json/JsonSerializer.xml @@ -43,6 +43,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa + + + Parses the text representing a single JSON value into an instance of a specified type. + + @@ -1498,6 +1503,11 @@ The used to create the instance of the The method on the provided did not return a compatible for . + + + Parses the text representing a single JSON value into a . + + @@ -2498,6 +2508,12 @@ The used to create the instance of the There is no compatible for or its serializable members. + + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + + @@ -2841,6 +2857,12 @@ There is remaining data in the stream. The cancellation token was canceled. This exception is stored into the returned task. + + + Reads the UTF-8 encoded text representing a single JSON value into a . + The Stream will be read to completion. + + @@ -3104,6 +3126,11 @@ There is remaining data in the stream. The cancellation token was canceled. This exception is stored into the returned task. + + + Wraps the UTF-8 encoded text into an that can be used to deserialize root-level JSON arrays in a streaming manner. + + @@ -3603,6 +3630,11 @@ There is remaining data in the stream. The value of the property is backed by the "System.Text.Json.JsonSerializer.IsReflectionEnabledByDefault" setting and defaults to if unset. + + + Converts the value of a specified type into a JSON string. + + @@ -4108,6 +4140,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The method of the provided returns for the type to convert. + + + Converts the provided value into a . + + @@ -4474,6 +4511,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa There is no compatible for or its serializable members. + + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + + @@ -4812,6 +4854,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The cancellation token was canceled. This exception is stored into the returned task. + + + Converts the provided value to UTF-8 encoded JSON text and write it to the . + + @@ -5256,6 +5303,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa To be added. + + + Converts the provided value into a . + + @@ -5405,6 +5457,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa or is . + + + Converts the provided value into a . + + @@ -5511,6 +5568,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa is . + + + Converts the provided value into a . + + @@ -5653,6 +5715,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa or is . + + + Converts the provided value into a . + + @@ -5752,6 +5819,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa is . + + + Converts the provided value into a . + + @@ -5899,6 +5971,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa or is . + + + Converts the provided value into a . + + @@ -6004,6 +6081,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa is . + + + Converts the provided value into a array. + + @@ -6174,6 +6256,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The method of the provided returns for the type to convert. + + + Converts the provided value into a array. + + diff --git a/xml/System.Text.Json/JsonSerializerOptions.xml b/xml/System.Text.Json/JsonSerializerOptions.xml index 36308be26a9..d2ff15d7e77 100644 --- a/xml/System.Text.Json/JsonSerializerOptions.xml +++ b/xml/System.Text.Json/JsonSerializerOptions.xml @@ -46,6 +46,11 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa + + + Initializes a new instance of the class. + + @@ -903,6 +908,11 @@ For more information, see [How to ignore properties with System.Text.Json](/dotn Read-only instances use caching when querying and metadata. + + + Marks the current instance as read-only to prevent any further user modification. + + diff --git a/xml/System.Text.Json/Utf8JsonReader.xml b/xml/System.Text.Json/Utf8JsonReader.xml index 754b3109a95..a60b2d26902 100644 --- a/xml/System.Text.Json/Utf8JsonReader.xml +++ b/xml/System.Text.Json/Utf8JsonReader.xml @@ -58,6 +58,11 @@ For more information, see [Use Utf8JsonReader](/dotnet/standard/serialization/sy + + + Initializes a new instance of the class. + + @@ -259,6 +264,11 @@ This is the reason why the constructor accepts a To be added. + + + Copies the current JSON token value from the source, unescaped, as UTF-8 bytes to a buffer. + + @@ -2217,6 +2227,11 @@ Since this property returns the raw bytes, avoid using it for text comparison. I + + + Compares the string text to the unescaped JSON token value in the source and returns a value that indicates whether they match. + + diff --git a/xml/System.Text.Json/Utf8JsonWriter.xml b/xml/System.Text.Json/Utf8JsonWriter.xml index c4220a912b7..5dd083203cf 100644 --- a/xml/System.Text.Json/Utf8JsonWriter.xml +++ b/xml/System.Text.Json/Utf8JsonWriter.xml @@ -56,6 +56,11 @@ For more information, see [How to write custom serializers and deserializers wit + + + Initializes a new instance of the class. + + @@ -431,6 +436,11 @@ This method stores in the task it returns all non-usage exceptions that the meth To be added. + + + Resets the internal state of this instance so that it can be reused. + + @@ -607,6 +617,11 @@ The will continue to use the original wri To be added. + + + Writes the property name and raw bytes value (as a Base64 encoded JSON string) as part of a name/value pair of a JSON object. + + @@ -876,6 +891,11 @@ The bytes are encoded before writing. Validation is enabled, and this method would result in writing invalid JSON. + + + Writes the pre-encoded property name and value (as a JSON literal true or false) as part of a name/value pair of a JSON object. + + @@ -1085,6 +1105,11 @@ The property name should already be escaped when the instance of Validation is enabled, and the operation would result in writing invalid JSON. + + + Writes a UTF-8 text value as a JSON comment. + + @@ -1281,6 +1306,11 @@ The comment value is not escaped before writing. Validation is enabled, and the operation would result in writing invalid JSON. + + + Writes the pre-encoded property name and the JSON literal null as part of a name/value pair of a JSON object. + + @@ -1479,6 +1509,11 @@ The property name should already be escaped when the instance of Validation is enabled, and the operation would result in writing invalid JSON. + + + Writes the pre-encoded property name and value (as a JSON number) as part of a name/value pair of a JSON object. + + @@ -2839,6 +2874,11 @@ The property name should already be escaped when the instance of Validation is enabled, and this method would result in writing invalid JSON. + + + Writes a value (as a JSON number). + + @@ -3144,6 +3184,11 @@ This method writes the value using the default Validation is enabled, and the operation would result in writing invalid JSON. + + + Writes the property name (as a JSON string) as the first part of a name/value pair of a JSON object. + + @@ -3313,6 +3358,11 @@ The property name should already be escaped when the instance of Validation is enabled, and this write operation would produce invalid JSON. + + + Writes the input as JSON content. It is expected that the input content is a single complete JSON value. + + @@ -3513,6 +3563,11 @@ The and is , and the input is not a valid, complete, single JSON value according to the JSON RFC, or the input JSON exceeds a recursive depth of 64. + + + Writes the beginning of a JSON array. + + @@ -3731,6 +3786,11 @@ The property name should already be escaped when the instance of + + + Writes the beginning of a JSON object. + + @@ -3949,6 +4009,11 @@ The property name should already be escaped when the instance of + + + Writes the property name and pre-encoded value (as a JSON string) as part of a name/value pair of a JSON object. + + @@ -5271,6 +5336,11 @@ The property name and value should already be escaped when the instance of Validation is enabled, and the write operation would produce invalid JSON. + + + Writes a UTF-8 text value (as a JSON string). + + @@ -5565,6 +5635,11 @@ The value should already be escaped when the instance of Validation is enabled, and the write operation would produce invalid JSON. + + + Writes the text value segment as a partial JSON string. + + diff --git a/xml/System.Text.RegularExpressions/CaptureCollection.xml b/xml/System.Text.RegularExpressions/CaptureCollection.xml index e3f3fdaec6d..49c2b65721e 100644 --- a/xml/System.Text.RegularExpressions/CaptureCollection.xml +++ b/xml/System.Text.RegularExpressions/CaptureCollection.xml @@ -130,6 +130,11 @@ + + + Copies all the elements of the collection to the given array beginning at the given index. + + diff --git a/xml/System.Text.RegularExpressions/GeneratedRegexAttribute.xml b/xml/System.Text.RegularExpressions/GeneratedRegexAttribute.xml index 7de7d70e72a..d5a548d7307 100644 --- a/xml/System.Text.RegularExpressions/GeneratedRegexAttribute.xml +++ b/xml/System.Text.RegularExpressions/GeneratedRegexAttribute.xml @@ -54,6 +54,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Text.RegularExpressions/GroupCollection.xml b/xml/System.Text.RegularExpressions/GroupCollection.xml index f907aa4e203..cfb872c60c1 100644 --- a/xml/System.Text.RegularExpressions/GroupCollection.xml +++ b/xml/System.Text.RegularExpressions/GroupCollection.xml @@ -188,6 +188,11 @@ To be added. + + + Copies all the elements of the collection to the given array beginning at the given index. + + diff --git a/xml/System.Text.RegularExpressions/MatchCollection.xml b/xml/System.Text.RegularExpressions/MatchCollection.xml index 6007b127642..4488e245c1e 100644 --- a/xml/System.Text.RegularExpressions/MatchCollection.xml +++ b/xml/System.Text.RegularExpressions/MatchCollection.xml @@ -141,6 +141,11 @@ + + + Copies all the elements of the collection to the given array starting at the given index. + + diff --git a/xml/System.Text.RegularExpressions/Regex.xml b/xml/System.Text.RegularExpressions/Regex.xml index 75c638e44fc..5dc2f1b870e 100644 --- a/xml/System.Text.RegularExpressions/Regex.xml +++ b/xml/System.Text.RegularExpressions/Regex.xml @@ -1192,6 +1192,11 @@ + + + Searches an input span for all occurrences of a regular expression and returns the number of matches. + + @@ -1592,6 +1597,11 @@ A regular expression parsing error occurred. + + + Searches an input span for all occurrences of a regular expression and returns a to iterate over the matches. + + @@ -1847,6 +1857,11 @@ A regular expression parsing error occurred. + + + Searches an input span for all occurrences of a regular expression and returns a to iterate over the splits around matches. + + diff --git a/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml b/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml index fde2f128a76..ef4afeaadf7 100644 --- a/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml +++ b/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml @@ -43,6 +43,11 @@ To be added. + + + Initializes a new instance of the class. + + @@ -112,6 +117,11 @@ This is intended to be called only by compiler-generated code. Arguments are not validated as they'd otherwise be for members intended to be used directly. + + + Writes the specified value to the handler. + + @@ -362,6 +372,11 @@ To be added. + + + Writes the specified value to the handler. + + diff --git a/xml/System.Text.Unicode/Utf8.xml b/xml/System.Text.Unicode/Utf8.xml index a2f481f896b..eb13e5df32a 100644 --- a/xml/System.Text.Unicode/Utf8.xml +++ b/xml/System.Text.Unicode/Utf8.xml @@ -1,91 +1,91 @@ - - - - - - - - - System.Runtime - 4.2.1.0 - 4.2.2.0 - 5.0.0.0 - 6.0.0.0 - 7.0.0.0 - 8.0.0.0 - 9.0.0.0 - 10.0.0.0 - 11.0.0.0 - - - Microsoft.Bcl.Memory - 10.0.0.0 - 10.0.0.1 - 10.0.0.2 - 11.0.0.0 - - - - - - - System.Object - - - - Provides static methods that convert chunked data between UTF-8 and UTF-16 encodings. - To be added. - - - - - - - - - Method - - System.Runtime - 4.2.1.0 - 4.2.2.0 - 5.0.0.0 - 6.0.0.0 - 7.0.0.0 - 8.0.0.0 - 9.0.0.0 - 10.0.0.0 - 11.0.0.0 - - - Microsoft.Bcl.Memory - 10.0.0.0 - 10.0.0.1 - 10.0.0.2 - 11.0.0.0 - - - System.Buffers.OperationStatus - - - - - - - - - - - A UTF-16 encoded read-only character span. - A UTF-8 encoded byte span. - When the method returns, the number of characters read from . - When the method returns, the number of bytes written to . - - to replace invalid UTF-16 sequences in with U+FFFD; to return if invalid characters are found in . - - if the method should not return ; otherwise, . - Converts a UTF-16 character span to a UTF-8 encoded byte span. - A value that indicates that status of the conversion. - + + + + + + + + + System.Runtime + 4.2.1.0 + 4.2.2.0 + 5.0.0.0 + 6.0.0.0 + 7.0.0.0 + 8.0.0.0 + 9.0.0.0 + 10.0.0.0 + 11.0.0.0 + + + Microsoft.Bcl.Memory + 10.0.0.0 + 10.0.0.1 + 10.0.0.2 + 11.0.0.0 + + + + + + + System.Object + + + + Provides static methods that convert chunked data between UTF-8 and UTF-16 encodings. + To be added. + + + + + + + + + Method + + System.Runtime + 4.2.1.0 + 4.2.2.0 + 5.0.0.0 + 6.0.0.0 + 7.0.0.0 + 8.0.0.0 + 9.0.0.0 + 10.0.0.0 + 11.0.0.0 + + + Microsoft.Bcl.Memory + 10.0.0.0 + 10.0.0.1 + 10.0.0.2 + 11.0.0.0 + + + System.Buffers.OperationStatus + + + + + + + + + + + A UTF-16 encoded read-only character span. + A UTF-8 encoded byte span. + When the method returns, the number of characters read from . + When the method returns, the number of bytes written to . + + to replace invalid UTF-16 sequences in with U+FFFD; to return if invalid characters are found in . + + if the method should not return ; otherwise, . + Converts a UTF-16 character span to a UTF-8 encoded byte span. + A value that indicates that status of the conversion. + . If 'isFinalBlock' is `true`, the method never returns . - ]]> - - - - - - - - - - - Method - - System.Runtime - 11.0.0.0 - - - Microsoft.Bcl.Memory - - - System.Int32 - - - - - - To be added. - To be added. - To be added. - To be added. - - - - - - - - - - Method - - System.Runtime - 8.0.0.0 - 9.0.0.0 - 10.0.0.0 - 11.0.0.0 - - - Microsoft.Bcl.Memory - 10.0.0.0 - 10.0.0.1 - 10.0.0.2 - 11.0.0.0 - - - System.Boolean - - - - - - The string. - Validates that the value is well-formed UTF-8. - - if value is well-formed UTF-8, otherwise. - To be added. - - - - - - - - - Method - - System.Runtime - 4.2.1.0 - 4.2.2.0 - 5.0.0.0 - 6.0.0.0 - 7.0.0.0 - 8.0.0.0 - 9.0.0.0 - 10.0.0.0 - 11.0.0.0 - - - Microsoft.Bcl.Memory - 10.0.0.0 - 10.0.0.1 - 10.0.0.2 - 11.0.0.0 - - - System.Buffers.OperationStatus - - - - - - - - - - - A UTF-8 encoded read-only byte span. - A UTF-16 encoded character span. - When the method returns, the number of bytes read from . - When the method returns, the number of characters written to . - - to replace invalid UTF-8 sequences in with U+FFFD; to return if invalid characters are found in . - - if the method should not return ; otherwise, . - Converts a UTF-8 encoded read-only byte span to a UTF-16 encoded character span. - A value that indicates the status of the conversion. - + ]]> + + + + + + + + + + + Method + + System.Runtime + 11.0.0.0 + + + Microsoft.Bcl.Memory + + + System.Int32 + + + + + + To be added. + To be added. + To be added. + To be added. + + + + + + + + + + Method + + System.Runtime + 8.0.0.0 + 9.0.0.0 + 10.0.0.0 + 11.0.0.0 + + + Microsoft.Bcl.Memory + 10.0.0.0 + 10.0.0.1 + 10.0.0.2 + 11.0.0.0 + + + System.Boolean + + + + + + The string. + Validates that the value is well-formed UTF-8. + + if value is well-formed UTF-8, otherwise. + To be added. + + + + + + + + + Method + + System.Runtime + 4.2.1.0 + 4.2.2.0 + 5.0.0.0 + 6.0.0.0 + 7.0.0.0 + 8.0.0.0 + 9.0.0.0 + 10.0.0.0 + 11.0.0.0 + + + Microsoft.Bcl.Memory + 10.0.0.0 + 10.0.0.1 + 10.0.0.2 + 11.0.0.0 + + + System.Buffers.OperationStatus + + + + + + + + + + + A UTF-8 encoded read-only byte span. + A UTF-16 encoded character span. + When the method returns, the number of bytes read from . + When the method returns, the number of characters written to . + + to replace invalid UTF-8 sequences in with U+FFFD; to return if invalid characters are found in . + + if the method should not return ; otherwise, . + Converts a UTF-8 encoded read-only byte span to a UTF-16 encoded character span. + A value that indicates the status of the conversion. + . If 'isFinalBlock' is `true`, the method never returns . - ]]> - - - - - - - - - - - Method - - System.Runtime - 8.0.0.0 - 9.0.0.0 - 10.0.0.0 - 11.0.0.0 - - - Microsoft.Bcl.Memory - - - System.Boolean - - - - - - - [System.Runtime.CompilerServices.InterpolatedStringHandlerArgument("destination")] - [<System.Runtime.CompilerServices.InterpolatedStringHandlerArgument("destination")>] - - - - - - - The span to which the interpolated string should be formatted. - The interpolated string. - When this method returns, contains the number of characters written to the span. - Writes the specified interpolated string to the UTF-8 byte span. - - if the entire interpolated string could be formatted successfully; otherwise, . - To be added. - - - - - - - - - - Method - - System.Runtime - 8.0.0.0 - 9.0.0.0 - 10.0.0.0 - 11.0.0.0 - - - Microsoft.Bcl.Memory - - - System.Boolean - - - - - - - [System.Runtime.CompilerServices.Nullable(2)] - [<System.Runtime.CompilerServices.Nullable(2)>] - - - - - - - [System.Runtime.CompilerServices.InterpolatedStringHandlerArgument(new System.String[] { "destination", "provider" })] - [<System.Runtime.CompilerServices.InterpolatedStringHandlerArgument(new System.String[] { "destination", "provider" })>] - - - - - - - The span to which the interpolated string should be formatted. - An object that supplies culture-specific formatting information. - The interpolated string. - When this method returns, contains the number of characters written to the span. - Writes the specified interpolated string to the UTF-8 byte span. - - if the entire interpolated string could be formatted successfully; otherwise, . - To be added. - - - - + ]]> + + + + + + Writes the specified interpolated string to the UTF-8 byte span. + + + + + + + + + + Method + + System.Runtime + 8.0.0.0 + 9.0.0.0 + 10.0.0.0 + 11.0.0.0 + + + Microsoft.Bcl.Memory + + + System.Boolean + + + + + + + [System.Runtime.CompilerServices.InterpolatedStringHandlerArgument("destination")] + [<System.Runtime.CompilerServices.InterpolatedStringHandlerArgument("destination")>] + + + + + + + The span to which the interpolated string should be formatted. + The interpolated string. + When this method returns, contains the number of characters written to the span. + Writes the specified interpolated string to the UTF-8 byte span. + + if the entire interpolated string could be formatted successfully; otherwise, . + To be added. + + + + + + + + + + Method + + System.Runtime + 8.0.0.0 + 9.0.0.0 + 10.0.0.0 + 11.0.0.0 + + + Microsoft.Bcl.Memory + + + System.Boolean + + + + + + + [System.Runtime.CompilerServices.Nullable(2)] + [<System.Runtime.CompilerServices.Nullable(2)>] + + + + + + + [System.Runtime.CompilerServices.InterpolatedStringHandlerArgument(new System.String[] { "destination", "provider" })] + [<System.Runtime.CompilerServices.InterpolatedStringHandlerArgument(new System.String[] { "destination", "provider" })>] + + + + + + + The span to which the interpolated string should be formatted. + An object that supplies culture-specific formatting information. + The interpolated string. + When this method returns, contains the number of characters written to the span. + Writes the specified interpolated string to the UTF-8 byte span. + + if the entire interpolated string could be formatted successfully; otherwise, . + To be added. + + + + diff --git a/xml/System.Text/Ascii.xml b/xml/System.Text/Ascii.xml index d135b202a08..3ce439a5178 100644 --- a/xml/System.Text/Ascii.xml +++ b/xml/System.Text/Ascii.xml @@ -21,6 +21,11 @@ For APIs that take both a source and a destination buffer, the behavior of the method is undefined if the source and destination buffers overlap, unless the description specifies otherwise. The behavior of all APIs is undefined if another thread mutates the buffers while these APIs are operating on them. All case-conversion APIs are culture-unaware. + + + Determines whether the provided buffers contain equal ASCII characters. + + @@ -148,6 +153,11 @@ + + + Determines whether the provided buffers contain equal ASCII characters, ignoring case considerations. + + @@ -307,6 +317,11 @@ To be added. + + + Determines whether the provided value is ASCII byte. + + @@ -423,6 +438,11 @@ To be added. + + + Copies text from a source buffer to a destination buffer, converting ASCII letters to lowercase during the copy. + + @@ -551,6 +571,11 @@ In-place conversion is prohibited, please use for that. + + + Performs in-place uppercase conversion. + + @@ -611,6 +636,11 @@ To be added. + + + Copies text from a source buffer to a destination buffer, converting ASCII letters to uppercase during the copy. + + @@ -739,6 +769,11 @@ In-place conversion is prohibited, please use for that. + + + Performs in-place lowercase conversion. + + @@ -831,6 +866,11 @@ To be added. + + + Trims all leading and trailing ASCII whitespaces from the buffer. + + @@ -888,6 +928,11 @@ + + + Trims all trailing ASCII whitespaces from the buffer. + + @@ -945,6 +990,11 @@ + + + Trims all leading ASCII whitespaces from the buffer. + + diff --git a/xml/System.Text/CodePagesEncodingProvider.xml b/xml/System.Text/CodePagesEncodingProvider.xml index f9beb242a73..6b75e24a138 100644 --- a/xml/System.Text/CodePagesEncodingProvider.xml +++ b/xml/System.Text/CodePagesEncodingProvider.xml @@ -88,7 +88,7 @@ When no encoding provider is registered, `GetEncoding(0)` returns UTF-8 on all p 4.1.2.0 - To be added. + Returns the encoding associated with the specified code page identifier or name. To be added. + + + Converts a to encoded bytes and writes the result to . + + @@ -241,6 +246,11 @@ contains data that cannot be encoded and is configured to throw when such data is seen. + + + Encodes the specified into a array using the specified . + + @@ -432,6 +442,11 @@ contains data that cannot be encoded and is configured to throw when such data is seen. + + + Decodes the specified to s using the specified and writes the result to . + + diff --git a/xml/System.Text/RedactionStringBuilderExtensions.xml b/xml/System.Text/RedactionStringBuilderExtensions.xml index 52ac563f9af..d9ee35be8b2 100644 --- a/xml/System.Text/RedactionStringBuilderExtensions.xml +++ b/xml/System.Text/RedactionStringBuilderExtensions.xml @@ -50,6 +50,11 @@ To be added. + + + Redacts potentially sensitive data and appends it to a instance. + + diff --git a/xml/System.Text/Rune.xml b/xml/System.Text/Rune.xml index 2b9f5ebe6ab..7f925b97c13 100644 --- a/xml/System.Text/Rune.xml +++ b/xml/System.Text/Rune.xml @@ -266,6 +266,11 @@ For similar types in other programming languages, see [Rust's primitive `char` t + + + Initializes a new instance of the class. + + @@ -714,6 +719,11 @@ This method is very similar to is not large enough to hold the output. + + + Returns a value that indicates whether the current instance and a specified rune are equal. + + @@ -1483,6 +1493,11 @@ For more information, see + + + Returns a value that indicates whether a 32-bit signed integer represents a valid Unicode scalar value; that is, it is in the range [ U+0000..U+D7FF ], inclusive; or [ U+E000..U+10FFFF ], inclusive. + + @@ -1637,6 +1652,11 @@ For more information, see To be added. + + + Defines an explicit conversion of a 32-bit signed integer to a . + + @@ -2378,6 +2398,11 @@ This member is an explicit interface member implementation. It can be used only To be added. + + + Attempts to create a from a specified signed integer that represents a Unicode scalar value. + + diff --git a/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml b/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml index f253de877dd..04ba3f86d55 100644 --- a/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml +++ b/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml @@ -45,6 +45,11 @@ To be added. + + + Initializes a new instance of the class. + + @@ -130,6 +135,11 @@ This is intended to be called only by compiler-generated code. Arguments are not + + + Writes the specified value to the handler. + + @@ -291,6 +301,11 @@ This is intended to be called only by compiler-generated code. Arguments are not To be added. + + + Writes the specified value to the handler. + + diff --git a/xml/System.Text/StringBuilder.xml b/xml/System.Text/StringBuilder.xml index 3787023df77..f8dfb30156d 100644 --- a/xml/System.Text/StringBuilder.xml +++ b/xml/System.Text/StringBuilder.xml @@ -4010,6 +4010,11 @@ The index of a format item is less than 0 (zero), or greater than or equal to th The index of a format item is greater than or equal to the number of supplied arguments. + + + Concatenates the strings of the provided span, using the specified separator between each string, then appends the result to the current instance of the string builder. + + @@ -4434,6 +4439,11 @@ The index of a format item is less than 0 (zero), or greater than or equal to th To be added. + + + Concatenates and appends the members of a collection, using the specified separator between each member. + + @@ -4968,6 +4978,11 @@ The following example instantiates a object wit + + + Copies the characters from a specified segment of this instance to a destination span. + + @@ -5197,6 +5212,11 @@ The following example instantiates a object wit To be added. + + + Returns a value indicating whether this instance is equal to a specified object. + + diff --git a/xml/System.Threading.Channels/Channel.xml b/xml/System.Threading.Channels/Channel.xml index 6fe0d3c015d..250367aa9f8 100644 --- a/xml/System.Threading.Channels/Channel.xml +++ b/xml/System.Threading.Channels/Channel.xml @@ -35,6 +35,11 @@ To be added. + + + Creates a channel subject to the provided options. + + @@ -181,6 +186,11 @@ is . + + + Creates an unbounded channel subject to the provided options. + + @@ -268,6 +278,11 @@ is . + + + Creates an unbounded prioritized channel subject to the provided options. + + diff --git a/xml/System.Threading.Channels/ChannelClosedException.xml b/xml/System.Threading.Channels/ChannelClosedException.xml index ded93893806..9f7544f934f 100644 --- a/xml/System.Threading.Channels/ChannelClosedException.xml +++ b/xml/System.Threading.Channels/ChannelClosedException.xml @@ -40,6 +40,11 @@ To be added. + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Channels/Channel`2.xml b/xml/System.Threading.Channels/Channel`2.xml index 3aa036babf2..4c557d101c7 100644 --- a/xml/System.Threading.Channels/Channel`2.xml +++ b/xml/System.Threading.Channels/Channel`2.xml @@ -80,6 +80,11 @@ To be added. + + + Implicit cast from a to its readable half. + + diff --git a/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml b/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml index b1fe710169f..e29cb77d41d 100644 --- a/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml +++ b/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml @@ -197,6 +197,11 @@ To be added. + + + Dispose method for implementations to write. + + diff --git a/xml/System.Threading.RateLimiting/RateLimitLease.xml b/xml/System.Threading.RateLimiting/RateLimitLease.xml index b1a819b5eb4..781a1b33a41 100644 --- a/xml/System.Threading.RateLimiting/RateLimitLease.xml +++ b/xml/System.Threading.RateLimiting/RateLimitLease.xml @@ -48,6 +48,11 @@ To be added. + + + Dispose method for implementations to write. + + diff --git a/xml/System.Threading.RateLimiting/RateLimiter.xml b/xml/System.Threading.RateLimiting/RateLimiter.xml index df698638c1d..0a84ad18b1e 100644 --- a/xml/System.Threading.RateLimiting/RateLimiter.xml +++ b/xml/System.Threading.RateLimiting/RateLimiter.xml @@ -226,6 +226,11 @@ is an empty array. + + + Dispose method for implementations to write. + + diff --git a/xml/System.Threading.Tasks.Dataflow/ActionBlock`1.xml b/xml/System.Threading.Tasks.Dataflow/ActionBlock`1.xml index 4a6a063e64b..bd2580855de 100644 --- a/xml/System.Threading.Tasks.Dataflow/ActionBlock`1.xml +++ b/xml/System.Threading.Tasks.Dataflow/ActionBlock`1.xml @@ -80,6 +80,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/BatchBlock`1.xml b/xml/System.Threading.Tasks.Dataflow/BatchBlock`1.xml index 8fd78f5f94b..c316e9cd96a 100644 --- a/xml/System.Threading.Tasks.Dataflow/BatchBlock`1.xml +++ b/xml/System.Threading.Tasks.Dataflow/BatchBlock`1.xml @@ -89,6 +89,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml b/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml index a8fc53815d1..cbc800d9e62 100644 --- a/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml +++ b/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`2.xml @@ -89,6 +89,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`3.xml b/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`3.xml index 5326f543c8f..6aabe0a0960 100644 --- a/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`3.xml +++ b/xml/System.Threading.Tasks.Dataflow/BatchedJoinBlock`3.xml @@ -98,6 +98,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/BroadcastBlock`1.xml b/xml/System.Threading.Tasks.Dataflow/BroadcastBlock`1.xml index 736fb6a2343..bdbc07b3a14 100644 --- a/xml/System.Threading.Tasks.Dataflow/BroadcastBlock`1.xml +++ b/xml/System.Threading.Tasks.Dataflow/BroadcastBlock`1.xml @@ -91,6 +91,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml b/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml index 3d10554525e..f0b768cd116 100644 --- a/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml +++ b/xml/System.Threading.Tasks.Dataflow/BufferBlock`1.xml @@ -89,6 +89,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml b/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml index c657fc34219..74d4440bc42 100644 --- a/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml +++ b/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml @@ -143,6 +143,11 @@ To be added. + + + Monitors two dataflow sources, invoking the provided handler for whichever source makes data available first. + + @@ -303,6 +308,11 @@ The is . + + + Monitors three dataflow sources, invoking the provided handler for whichever source makes data available first. + + @@ -589,6 +599,11 @@ batchBlock.Complete(); + + + Links the to the specified . + + @@ -817,6 +832,11 @@ batchBlock.Complete(); To be added. + + + Provides a that asynchronously monitors the source for available output. + + @@ -976,6 +996,11 @@ batchBlock.Complete(); + + + Synchronously receives a value from a specified source. + + @@ -1268,6 +1293,11 @@ batchBlock.Complete(); The cancellation token was canceled. This exception is stored into the returned task. + + + Asynchronously receives a value from a specified source. + + @@ -1490,6 +1520,11 @@ batchBlock.Complete(); The cancellation token was canceled. This exception is stored into the returned task. + + + Asynchronously offers a message to the target message block, allowing for postponement. + + diff --git a/xml/System.Threading.Tasks.Dataflow/DataflowMessageHeader.xml b/xml/System.Threading.Tasks.Dataflow/DataflowMessageHeader.xml index 11c78f3f167..313683001a2 100644 --- a/xml/System.Threading.Tasks.Dataflow/DataflowMessageHeader.xml +++ b/xml/System.Threading.Tasks.Dataflow/DataflowMessageHeader.xml @@ -89,6 +89,11 @@ To be added. + + + Checks boxed instances for equality by ID. + + diff --git a/xml/System.Threading.Tasks.Dataflow/JoinBlock`2.xml b/xml/System.Threading.Tasks.Dataflow/JoinBlock`2.xml index 2b2e234f444..31a9a58d1d7 100644 --- a/xml/System.Threading.Tasks.Dataflow/JoinBlock`2.xml +++ b/xml/System.Threading.Tasks.Dataflow/JoinBlock`2.xml @@ -89,6 +89,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/JoinBlock`3.xml b/xml/System.Threading.Tasks.Dataflow/JoinBlock`3.xml index bb905dd0485..7617ed9776c 100644 --- a/xml/System.Threading.Tasks.Dataflow/JoinBlock`3.xml +++ b/xml/System.Threading.Tasks.Dataflow/JoinBlock`3.xml @@ -98,6 +98,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/TransformBlock`2.xml b/xml/System.Threading.Tasks.Dataflow/TransformBlock`2.xml index 6c0fd12ebce..c7ccb5234f9 100644 --- a/xml/System.Threading.Tasks.Dataflow/TransformBlock`2.xml +++ b/xml/System.Threading.Tasks.Dataflow/TransformBlock`2.xml @@ -92,6 +92,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/TransformManyBlock`2.xml b/xml/System.Threading.Tasks.Dataflow/TransformManyBlock`2.xml index a9028b156f4..88af210e92b 100644 --- a/xml/System.Threading.Tasks.Dataflow/TransformManyBlock`2.xml +++ b/xml/System.Threading.Tasks.Dataflow/TransformManyBlock`2.xml @@ -92,6 +92,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks.Dataflow/WriteOnceBlock`1.xml b/xml/System.Threading.Tasks.Dataflow/WriteOnceBlock`1.xml index a3d6e8cbfa0..14bade2f017 100644 --- a/xml/System.Threading.Tasks.Dataflow/WriteOnceBlock`1.xml +++ b/xml/System.Threading.Tasks.Dataflow/WriteOnceBlock`1.xml @@ -89,6 +89,11 @@ + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading.Tasks/Parallel.xml b/xml/System.Threading.Tasks/Parallel.xml index 3524e8923c7..dc972dbe099 100644 --- a/xml/System.Threading.Tasks/Parallel.xml +++ b/xml/System.Threading.Tasks/Parallel.xml @@ -645,6 +645,11 @@ The associated with the in the has been disposed. + + + Executes a loop with thread-local data in which iterations may run in parallel, and the state of the loop can be monitored and manipulated. + + @@ -1017,6 +1022,11 @@ The exception that contains all the individual exceptions thrown on all threads. + + + Executes a for loop in which iterations may run in parallel. + + @@ -2114,6 +2124,11 @@ The associated with the in the has been disposed. + + + Executes a ( in Visual Basic) operation with thread-local data on an in which iterations may run in parallel and the state of the loop can be monitored and manipulated. + + @@ -2914,6 +2929,11 @@ The exception that contains all the individual exceptions thrown on all threads. + + + Executes a for-each operation on an in which iterations may run in parallel. + + diff --git a/xml/System.Threading.Tasks/Task.xml b/xml/System.Threading.Tasks/Task.xml index 690b0ba60b1..a78c7de50a8 100644 --- a/xml/System.Threading.Tasks/Task.xml +++ b/xml/System.Threading.Tasks/Task.xml @@ -834,6 +834,11 @@ To retrieve the object's data, cast it back to the original type. + + + Configures an awaiter used to await this . + + @@ -1722,6 +1727,11 @@ End Sub The provided has already been disposed. + + + Creates a continuation that executes according to the specified continuation options and returns a value. + + @@ -4287,6 +4297,11 @@ This method is intended for compiler use rather than use directly in code. The task has been canceled. + + + Queues the specified work to run on the thread pool and returns a object that represents that work. + + @@ -6343,6 +6358,11 @@ An exception was thrown during The was canceled. + + + Gets a that will complete when this completes or when the specified timeout expires. + + @@ -6764,6 +6784,11 @@ An exception was thrown during The array contained a task. + + + Creates a task that will complete when all of the supplied tasks have completed. + + @@ -7246,6 +7271,11 @@ The returned task completes when any of the supplied tasks has completed. The re or was . + + + Creates a task that will complete when any of the supplied tasks have completed. + + @@ -7514,6 +7544,11 @@ The returned task completes when any of the supplied tasks has completed. The re or was . + + + Creates an that will yield the supplied tasks as those tasks complete. + + diff --git a/xml/System.Threading.Tasks/TaskCompletionSource.xml b/xml/System.Threading.Tasks/TaskCompletionSource.xml index 703b336db5d..8202857d87c 100644 --- a/xml/System.Threading.Tasks/TaskCompletionSource.xml +++ b/xml/System.Threading.Tasks/TaskCompletionSource.xml @@ -41,6 +41,11 @@ + + + Initializes a new instance of the class. + + @@ -159,6 +164,11 @@ The created by this instance and accessible t + + + Transitions the underlying into the state. + + @@ -218,6 +228,11 @@ The created by this instance and accessible t The underlying is already in one of the three final states: , , or . + + + Transitions the underlying into the state. + + @@ -382,6 +397,11 @@ This property gives a consumer access to the + + + Attempts to transition the underlying into the state. + + @@ -461,6 +481,11 @@ This operation will return `false` if the is + + + Attempts to transition the underlying into the state. + + diff --git a/xml/System.Threading.Tasks/TaskCompletionSource`1.xml b/xml/System.Threading.Tasks/TaskCompletionSource`1.xml index 5815c5fb5a1..674ab58d92a 100644 --- a/xml/System.Threading.Tasks/TaskCompletionSource`1.xml +++ b/xml/System.Threading.Tasks/TaskCompletionSource`1.xml @@ -301,6 +301,11 @@ How to: Wrap EAP Patterns in a Task + + + Transitions the underlying into the state. + + diff --git a/xml/System.Threading.Tasks/TaskFactory.xml b/xml/System.Threading.Tasks/TaskFactory.xml index 8e8934badc3..5d06986fdd9 100644 --- a/xml/System.Threading.Tasks/TaskFactory.xml +++ b/xml/System.Threading.Tasks/TaskFactory.xml @@ -837,6 +837,11 @@ The NotOn\* and OnlyOn\* , The provided has already been disposed. + + + Creates a continuation task that starts when a set of specified tasks has completed. + + @@ -1162,6 +1167,11 @@ The NotOn\* and OnlyOn\* , The provided has already been disposed. + + + Creates a continuation task that starts when a set of specified tasks has completed. + + @@ -1486,6 +1496,11 @@ The NotOn\* and OnlyOn\* , The provided has already been disposed. + + + Creates a continuation task that starts when a set of specified tasks has completed. + + @@ -2172,6 +2187,11 @@ The NotOn\* and OnlyOn\* , Task Cancellation + + + Creates a continuation that will be started upon the completion of any Task in the provided set. + + @@ -2514,6 +2534,11 @@ The array is empty. Task Cancellation + + + Creates a continuation that will be started upon the completion of any Task in the provided set. + + @@ -2856,6 +2881,11 @@ The NotOn\* and OnlyOn\* , Task Cancellation + + + Creates a continuation that will be started upon the completion of any Task in the provided set. + + @@ -3686,6 +3716,11 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns + + + Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -3882,6 +3917,11 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns + + + Creates a that executes an end method function when a specified completes. + + @@ -4326,6 +4366,11 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns + + + Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -4544,6 +4589,11 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns + + + Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -4758,6 +4808,11 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns + + + Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -4998,6 +5053,11 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns + + + Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -5234,6 +5294,11 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns + + + Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -6225,6 +6290,11 @@ You can use the method with an Task Cancellation + + + Creates and starts a task of type for the specified function delegate. + + diff --git a/xml/System.Threading.Tasks/TaskFactory`1.xml b/xml/System.Threading.Tasks/TaskFactory`1.xml index 210d6147556..50e7cdbe527 100644 --- a/xml/System.Threading.Tasks/TaskFactory`1.xml +++ b/xml/System.Threading.Tasks/TaskFactory`1.xml @@ -828,6 +828,11 @@ Task Cancellation + + + Creates a continuation task that will be started upon the completion of a set of provided tasks. + + @@ -1490,6 +1495,11 @@ Task Cancellation + + + Creates a continuation task that will be started upon the completion of any task in the provided set. + + @@ -2265,6 +2275,11 @@ Using TPL with Other Asynchronous Patterns + + + Creates a task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -2458,6 +2473,11 @@ Using TPL with Other Asynchronous Patterns + + + Creates a task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + @@ -2673,6 +2693,11 @@ Using TPL with Other Asynchronous Patterns + + + Creates a task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. + + diff --git a/xml/System.Threading.Tasks/Task`1.xml b/xml/System.Threading.Tasks/Task`1.xml index 44a261f7c4d..cc156fe7d23 100644 --- a/xml/System.Threading.Tasks/Task`1.xml +++ b/xml/System.Threading.Tasks/Task`1.xml @@ -646,6 +646,11 @@ For operations that do not return a value, you use the The argument is . + + + Configures an awaiter used to await this . + + @@ -1511,6 +1516,11 @@ For operations that do not return a value, you use the Chaining Tasks by Using Continuation Tasks + + + Creates a continuation that executes when the target completes. + + @@ -2545,6 +2555,11 @@ This method is intended for compiler use rather than use directly in code. How to: Return a Value from a Task + + + Gets a that will complete when this completes or when the specified timeout expires. + + diff --git a/xml/System.Threading.Tasks/ValueTask.xml b/xml/System.Threading.Tasks/ValueTask.xml index c4f9024cb94..2d0477a5026 100644 --- a/xml/System.Threading.Tasks/ValueTask.xml +++ b/xml/System.Threading.Tasks/ValueTask.xml @@ -98,6 +98,11 @@ Using a `ValueTask` instead of a introduces s + + + Initializes a new instance of the class. + + @@ -303,6 +308,11 @@ This method either returns the wrapped task object, if one exists, or it manufac To be added. + + + Determines whether the specified object is equal to the current instance. + + diff --git a/xml/System.Threading.Tasks/ValueTask`1.xml b/xml/System.Threading.Tasks/ValueTask`1.xml index c4db93b62f1..837224e3068 100644 --- a/xml/System.Threading.Tasks/ValueTask`1.xml +++ b/xml/System.Threading.Tasks/ValueTask`1.xml @@ -119,6 +119,11 @@ As such, the default choice for any asynchronous method should be to return a + + + Initializes a new instance of the class. + + @@ -390,6 +395,11 @@ This method either returns the wrapped task object, if one exists, or it manufac + + + Determines whether the specified object is equal to the current object. + + diff --git a/xml/System.Threading/CancellationToken.xml b/xml/System.Threading/CancellationToken.xml index cf3947be939..af98b57aab6 100644 --- a/xml/System.Threading/CancellationToken.xml +++ b/xml/System.Threading/CancellationToken.xml @@ -1096,6 +1096,11 @@ End If How to: Cancel a Task and Its Children + + + Registers a delegate that is called when this is canceled. + + diff --git a/xml/System.Threading/Interlocked.xml b/xml/System.Threading/Interlocked.xml index 2bfdf93a0c1..15bd16aba0a 100644 --- a/xml/System.Threading/Interlocked.xml +++ b/xml/System.Threading/Interlocked.xml @@ -302,6 +302,11 @@ The address of is a pointer. + + + Bitwise "ands" two 32-bit signed integers and replaces the first integer with the result, as an atomic operation. + + @@ -2543,6 +2548,11 @@ This method wraps a call to [FlushProcessWriteBuffers](/windows/win32/api/proces + + + Bitwise "ors" two 32-bit signed integers and replaces the first integer with the result, as an atomic operation. + + @@ -2746,6 +2756,11 @@ This method wraps a call to [FlushProcessWriteBuffers](/windows/win32/api/proces To be added. + + + Returns a 64-bit value, loaded as an atomic operation. + + diff --git a/xml/System.Threading/Lock.xml b/xml/System.Threading/Lock.xml index f1b20efba3a..e08fba070f4 100644 --- a/xml/System.Threading/Lock.xml +++ b/xml/System.Threading/Lock.xml @@ -194,6 +194,11 @@ For more information, see the Remarks for . To be added. + + + Tries to enter the lock without waiting. + + diff --git a/xml/System.Threading/PeriodicTimer.xml b/xml/System.Threading/PeriodicTimer.xml index ac64b5a7e72..a13b09e17e8 100644 --- a/xml/System.Threading/PeriodicTimer.xml +++ b/xml/System.Threading/PeriodicTimer.xml @@ -37,6 +37,11 @@ This timer is intended to be used only by a single consumer at a time: only one + + + Initializes a new instance of the class. + + diff --git a/xml/System.Threading/SpinWait.xml b/xml/System.Threading/SpinWait.xml index c4f340de50b..c89b3cee199 100644 --- a/xml/System.Threading/SpinWait.xml +++ b/xml/System.Threading/SpinWait.xml @@ -223,6 +223,11 @@ How to: Use SpinWait to Implement a Two-Phase Wait Operation + + + Performs a single spin. + + diff --git a/xml/System.Threading/Thread.xml b/xml/System.Threading/Thread.xml index a7715701e11..eee90316f21 100644 --- a/xml/System.Threading/Thread.xml +++ b/xml/System.Threading/Thread.xml @@ -3618,6 +3618,11 @@ The string assigned to the property can incl The thread was started and has terminated, or the call is not being made from the thread's context while the thread is running. + + + Causes the operating system to change the state of the current instance to . + + diff --git a/xml/System.Threading/ThreadPool.xml b/xml/System.Threading/ThreadPool.xml index 9ac41e9c48d..67c4cb2140c 100644 --- a/xml/System.Threading/ThreadPool.xml +++ b/xml/System.Threading/ThreadPool.xml @@ -1410,6 +1410,11 @@ If a thread pool implementation may have different types of threads, the count i + + + Queues the specified work item object to the thread pool. + + diff --git a/xml/System.Threading/ThreadingAclExtensions.xml b/xml/System.Threading/ThreadingAclExtensions.xml index 00a41de4359..1ae5b53b06e 100644 --- a/xml/System.Threading/ThreadingAclExtensions.xml +++ b/xml/System.Threading/ThreadingAclExtensions.xml @@ -49,6 +49,11 @@ + + + Returns the security descriptors for the specified . + + @@ -151,6 +156,11 @@ To be added. + + + Sets the security descriptors for the specified mutex. + + diff --git a/xml/System.Transactions/TransactionOptions.xml b/xml/System.Transactions/TransactionOptions.xml index a8857afc5be..43640a8f7be 100644 --- a/xml/System.Transactions/TransactionOptions.xml +++ b/xml/System.Transactions/TransactionOptions.xml @@ -62,6 +62,11 @@ + + + Indicates whether the current instance is equal to another instance of the same type. + + From 715f9534dfd0f91b1aef7a4cf4b7d7ed5aeb88e9 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Sat, 27 Jun 2026 08:43:26 -0700 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- .../JsonMetadataServices.xml | 2 +- xml/System.Text.Json/Utf8JsonReader.xml | 2 +- xml/System.Text/Ascii.xml | 6 +++--- xml/System.Text/EncodingExtensions.xml | 4 ++-- xml/System.Text/Rune.xml | 2 +- .../PartitionedRateLimiter`1.xml | 2 +- xml/System.Threading.RateLimiting/RateLimitLease.xml | 2 +- xml/System.Threading.RateLimiting/RateLimiter.xml | 2 +- xml/System.Threading.Tasks/Task.xml | 2 +- xml/System.Threading.Tasks/ValueTask.xml | 2 +- xml/System.Threading.Tasks/ValueTask`1.xml | 2 +- xml/System.Threading/ThreadingAclExtensions.xml | 4 ++-- 12 files changed, 16 insertions(+), 16 deletions(-) diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml index ed872d19cc2..3c52153fcb6 100644 --- a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml +++ b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml @@ -2019,7 +2019,7 @@ This API is for use by the output of the System.Text.Json source generator and s - Creates a instance that converts values. + Creates a instance that converts nullable values. diff --git a/xml/System.Text.Json/Utf8JsonReader.xml b/xml/System.Text.Json/Utf8JsonReader.xml index a60b2d26902..3b1505f769e 100644 --- a/xml/System.Text.Json/Utf8JsonReader.xml +++ b/xml/System.Text.Json/Utf8JsonReader.xml @@ -60,7 +60,7 @@ For more information, see [Use Utf8JsonReader](/dotnet/standard/serialization/sy - Initializes a new instance of the class. + Initializes a new instance of the structure. diff --git a/xml/System.Text/Ascii.xml b/xml/System.Text/Ascii.xml index 3ce439a5178..8349a593139 100644 --- a/xml/System.Text/Ascii.xml +++ b/xml/System.Text/Ascii.xml @@ -319,7 +319,7 @@ - Determines whether the provided value is ASCII byte. + Determines whether the provided value is an ASCII byte. @@ -573,7 +573,7 @@ - Performs in-place uppercase conversion. + Performs an in-place lowercase conversion. @@ -771,7 +771,7 @@ - Performs in-place lowercase conversion. + Performs an in-place uppercase conversion. diff --git a/xml/System.Text/EncodingExtensions.xml b/xml/System.Text/EncodingExtensions.xml index 39707fa9ac7..d8a7c02326e 100644 --- a/xml/System.Text/EncodingExtensions.xml +++ b/xml/System.Text/EncodingExtensions.xml @@ -32,7 +32,7 @@ - Converts a to encoded bytes and writes the result to . + Decodes a of bytes to values and writes the result to . @@ -444,7 +444,7 @@ - Decodes the specified to s using the specified and writes the result to . + Decodes the specified of bytes to values using the specified and writes the result to . diff --git a/xml/System.Text/Rune.xml b/xml/System.Text/Rune.xml index 7f925b97c13..742fee1263e 100644 --- a/xml/System.Text/Rune.xml +++ b/xml/System.Text/Rune.xml @@ -268,7 +268,7 @@ For similar types in other programming languages, see [Rust's primitive `char` t - Initializes a new instance of the class. + Initializes a new instance of the structure. diff --git a/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml b/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml index e29cb77d41d..4682d530e6b 100644 --- a/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml +++ b/xml/System.Threading.RateLimiting/PartitionedRateLimiter`1.xml @@ -199,7 +199,7 @@ - Dispose method for implementations to write. + Releases all resources used by the current instance. diff --git a/xml/System.Threading.RateLimiting/RateLimitLease.xml b/xml/System.Threading.RateLimiting/RateLimitLease.xml index 781a1b33a41..9b93289476a 100644 --- a/xml/System.Threading.RateLimiting/RateLimitLease.xml +++ b/xml/System.Threading.RateLimiting/RateLimitLease.xml @@ -50,7 +50,7 @@ - Dispose method for implementations to write. + Releases all resources used by the current instance. diff --git a/xml/System.Threading.RateLimiting/RateLimiter.xml b/xml/System.Threading.RateLimiting/RateLimiter.xml index 0a84ad18b1e..cf576537f79 100644 --- a/xml/System.Threading.RateLimiting/RateLimiter.xml +++ b/xml/System.Threading.RateLimiting/RateLimiter.xml @@ -228,7 +228,7 @@ - Dispose method for implementations to write. + Releases all resources used by the current instance. diff --git a/xml/System.Threading.Tasks/Task.xml b/xml/System.Threading.Tasks/Task.xml index a78c7de50a8..7803c49db40 100644 --- a/xml/System.Threading.Tasks/Task.xml +++ b/xml/System.Threading.Tasks/Task.xml @@ -4299,7 +4299,7 @@ This method is intended for compiler use rather than use directly in code. - Queues the specified work to run on the thread pool and returns a object that represents that work. + Queues the specified work to run on the thread pool and returns a that represents that work. diff --git a/xml/System.Threading.Tasks/ValueTask.xml b/xml/System.Threading.Tasks/ValueTask.xml index 2d0477a5026..e5f3cfae254 100644 --- a/xml/System.Threading.Tasks/ValueTask.xml +++ b/xml/System.Threading.Tasks/ValueTask.xml @@ -100,7 +100,7 @@ Using a `ValueTask` instead of a introduces s - Initializes a new instance of the class. + Initializes a new instance of the structure. diff --git a/xml/System.Threading.Tasks/ValueTask`1.xml b/xml/System.Threading.Tasks/ValueTask`1.xml index 837224e3068..26e601e293e 100644 --- a/xml/System.Threading.Tasks/ValueTask`1.xml +++ b/xml/System.Threading.Tasks/ValueTask`1.xml @@ -121,7 +121,7 @@ As such, the default choice for any asynchronous method should be to return a - Initializes a new instance of the class. + Initializes a new instance of the structure. diff --git a/xml/System.Threading/ThreadingAclExtensions.xml b/xml/System.Threading/ThreadingAclExtensions.xml index 1ae5b53b06e..38599c100cb 100644 --- a/xml/System.Threading/ThreadingAclExtensions.xml +++ b/xml/System.Threading/ThreadingAclExtensions.xml @@ -51,7 +51,7 @@ - Returns the security descriptors for the specified . + Returns the security descriptors for the specified . @@ -158,7 +158,7 @@ - Sets the security descriptors for the specified mutex. + Sets the security descriptors for the specified . From 3f9fa0e373fb6be4944e9ccc1a53c7f838c218df Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 1 Jul 2026 14:56:07 -0700 Subject: [PATCH 3/5] Merge generic and non-generic overloads into a single MemberGroup Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- xml/System.Text.Json.Nodes/JsonValue.xml | 5 -- xml/System.Text.Json/JsonSerializer.xml | 41 ----------- ...Utf8+TryWriteInterpolatedStringHandler.xml | 5 -- ...uilder+AppendInterpolatedStringHandler.xml | 5 -- xml/System.Text/StringBuilder.xml | 5 -- .../DataflowBlock.xml | 5 -- xml/System.Threading.Tasks/Parallel.xml | 10 --- xml/System.Threading.Tasks/Task.xml | 20 ------ xml/System.Threading.Tasks/TaskFactory.xml | 70 ------------------- xml/System.Threading.Tasks/TaskFactory`1.xml | 25 ------- xml/System.Threading.Tasks/Task`1.xml | 5 -- 11 files changed, 196 deletions(-) diff --git a/xml/System.Text.Json.Nodes/JsonValue.xml b/xml/System.Text.Json.Nodes/JsonValue.xml index 155d150aafd..965f1b692ce 100644 --- a/xml/System.Text.Json.Nodes/JsonValue.xml +++ b/xml/System.Text.Json.Nodes/JsonValue.xml @@ -1175,11 +1175,6 @@ To be added. - - - Initializes a new instance of the class that contains the specified value. - - diff --git a/xml/System.Text.Json/JsonSerializer.xml b/xml/System.Text.Json/JsonSerializer.xml index d86a0a5f9f5..223bb368601 100644 --- a/xml/System.Text.Json/JsonSerializer.xml +++ b/xml/System.Text.Json/JsonSerializer.xml @@ -1503,11 +1503,6 @@ The used to create the instance of the The method on the provided did not return a compatible for . - - - Parses the text representing a single JSON value into a . - - @@ -2857,12 +2852,6 @@ There is remaining data in the stream. The cancellation token was canceled. This exception is stored into the returned task. - - - Reads the UTF-8 encoded text representing a single JSON value into a . - The Stream will be read to completion. - - @@ -4140,11 +4129,6 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The method of the provided returns for the type to convert. - - - Converts the provided value into a . - - @@ -4854,11 +4838,6 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The cancellation token was canceled. This exception is stored into the returned task. - - - Converts the provided value to UTF-8 encoded JSON text and write it to the . - - @@ -5457,11 +5436,6 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa or is . - - - Converts the provided value into a . - - @@ -5715,11 +5689,6 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa or is . - - - Converts the provided value into a . - - @@ -5971,11 +5940,6 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa or is . - - - Converts the provided value into a . - - @@ -6256,11 +6220,6 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The method of the provided returns for the type to convert. - - - Converts the provided value into a array. - - diff --git a/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml b/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml index ef4afeaadf7..a168b2720bb 100644 --- a/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml +++ b/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml @@ -372,11 +372,6 @@ To be added. - - - Writes the specified value to the handler. - - diff --git a/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml b/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml index 04ba3f86d55..b6c7479b2dc 100644 --- a/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml +++ b/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml @@ -301,11 +301,6 @@ This is intended to be called only by compiler-generated code. Arguments are not To be added. - - - Writes the specified value to the handler. - - diff --git a/xml/System.Text/StringBuilder.xml b/xml/System.Text/StringBuilder.xml index f8dfb30156d..bd9445592a0 100644 --- a/xml/System.Text/StringBuilder.xml +++ b/xml/System.Text/StringBuilder.xml @@ -4439,11 +4439,6 @@ The index of a format item is less than 0 (zero), or greater than or equal to th To be added. - - - Concatenates and appends the members of a collection, using the specified separator between each member. - - diff --git a/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml b/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml index 74d4440bc42..c56081c3267 100644 --- a/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml +++ b/xml/System.Threading.Tasks.Dataflow/DataflowBlock.xml @@ -308,11 +308,6 @@ The is . - - - Monitors three dataflow sources, invoking the provided handler for whichever source makes data available first. - - diff --git a/xml/System.Threading.Tasks/Parallel.xml b/xml/System.Threading.Tasks/Parallel.xml index dc972dbe099..f82d01a6648 100644 --- a/xml/System.Threading.Tasks/Parallel.xml +++ b/xml/System.Threading.Tasks/Parallel.xml @@ -645,11 +645,6 @@ The associated with the in the has been disposed. - - - Executes a loop with thread-local data in which iterations may run in parallel, and the state of the loop can be monitored and manipulated. - - @@ -2124,11 +2119,6 @@ The associated with the in the has been disposed. - - - Executes a ( in Visual Basic) operation with thread-local data on an in which iterations may run in parallel and the state of the loop can be monitored and manipulated. - - diff --git a/xml/System.Threading.Tasks/Task.xml b/xml/System.Threading.Tasks/Task.xml index a78c7de50a8..a2b6f9686a9 100644 --- a/xml/System.Threading.Tasks/Task.xml +++ b/xml/System.Threading.Tasks/Task.xml @@ -1727,11 +1727,6 @@ End Sub The provided has already been disposed. - - - Creates a continuation that executes according to the specified continuation options and returns a value. - - @@ -4297,11 +4292,6 @@ This method is intended for compiler use rather than use directly in code. The task has been canceled. - - - Queues the specified work to run on the thread pool and returns a object that represents that work. - - @@ -6784,11 +6774,6 @@ An exception was thrown during The array contained a task. - - - Creates a task that will complete when all of the supplied tasks have completed. - - @@ -7271,11 +7256,6 @@ The returned task completes when any of the supplied tasks has completed. The re or was . - - - Creates a task that will complete when any of the supplied tasks have completed. - - diff --git a/xml/System.Threading.Tasks/TaskFactory.xml b/xml/System.Threading.Tasks/TaskFactory.xml index 5d06986fdd9..8e8934badc3 100644 --- a/xml/System.Threading.Tasks/TaskFactory.xml +++ b/xml/System.Threading.Tasks/TaskFactory.xml @@ -837,11 +837,6 @@ The NotOn\* and OnlyOn\* , The provided has already been disposed. - - - Creates a continuation task that starts when a set of specified tasks has completed. - - @@ -1167,11 +1162,6 @@ The NotOn\* and OnlyOn\* , The provided has already been disposed. - - - Creates a continuation task that starts when a set of specified tasks has completed. - - @@ -1496,11 +1486,6 @@ The NotOn\* and OnlyOn\* , The provided has already been disposed. - - - Creates a continuation task that starts when a set of specified tasks has completed. - - @@ -2187,11 +2172,6 @@ The NotOn\* and OnlyOn\* , Task Cancellation - - - Creates a continuation that will be started upon the completion of any Task in the provided set. - - @@ -2534,11 +2514,6 @@ The array is empty. Task Cancellation - - - Creates a continuation that will be started upon the completion of any Task in the provided set. - - @@ -2881,11 +2856,6 @@ The NotOn\* and OnlyOn\* , Task Cancellation - - - Creates a continuation that will be started upon the completion of any Task in the provided set. - - @@ -3716,11 +3686,6 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns - - - Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -3917,11 +3882,6 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns - - - Creates a that executes an end method function when a specified completes. - - @@ -4366,11 +4326,6 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns - - - Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -4589,11 +4544,6 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns - - - Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -4808,11 +4758,6 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns - - - Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -5053,11 +4998,6 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns - - - Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -5294,11 +5234,6 @@ The NotOn\* and OnlyOn\* , Using TPL with Other Asynchronous Patterns - - - Creates a that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -6290,11 +6225,6 @@ You can use the method with an Task Cancellation - - - Creates and starts a task of type for the specified function delegate. - - diff --git a/xml/System.Threading.Tasks/TaskFactory`1.xml b/xml/System.Threading.Tasks/TaskFactory`1.xml index 50e7cdbe527..210d6147556 100644 --- a/xml/System.Threading.Tasks/TaskFactory`1.xml +++ b/xml/System.Threading.Tasks/TaskFactory`1.xml @@ -828,11 +828,6 @@ Task Cancellation - - - Creates a continuation task that will be started upon the completion of a set of provided tasks. - - @@ -1495,11 +1490,6 @@ Task Cancellation - - - Creates a continuation task that will be started upon the completion of any task in the provided set. - - @@ -2275,11 +2265,6 @@ Using TPL with Other Asynchronous Patterns - - - Creates a task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -2473,11 +2458,6 @@ Using TPL with Other Asynchronous Patterns - - - Creates a task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - @@ -2693,11 +2673,6 @@ Using TPL with Other Asynchronous Patterns - - - Creates a task that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern. - - diff --git a/xml/System.Threading.Tasks/Task`1.xml b/xml/System.Threading.Tasks/Task`1.xml index cc156fe7d23..ef8c4b63f0f 100644 --- a/xml/System.Threading.Tasks/Task`1.xml +++ b/xml/System.Threading.Tasks/Task`1.xml @@ -1516,11 +1516,6 @@ For operations that do not return a value, you use the Chaining Tasks by Using Continuation Tasks - - - Creates a continuation that executes when the target completes. - - From 5db98e20182a62f0785f3b7135452f4dab47c34e Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 1 Jul 2026 16:17:49 -0700 Subject: [PATCH 4/5] Remove duplicate MemberGroup --- xml/System.Threading.Tasks/Task.xml | 19 +++---------------- 1 file changed, 3 insertions(+), 16 deletions(-) diff --git a/xml/System.Threading.Tasks/Task.xml b/xml/System.Threading.Tasks/Task.xml index cff7cc66d9e..f762c0097fb 100644 --- a/xml/System.Threading.Tasks/Task.xml +++ b/xml/System.Threading.Tasks/Task.xml @@ -3959,7 +3959,7 @@ This method is intended for compiler use rather than use directly in code. If is `true`, the task's is equal to , and its property will be non-null. > [!IMPORTANT] -> Retrieving the value of the property does not block the calling thread until the task has completed. +> Retrieving the value of the property does not block the calling thread until the task has completed. ]]> @@ -3976,8 +3976,7 @@ This method is intended for compiler use rather than use directly in code. method provides a set of overloads that make it easy to start a task by using default values. It is a lightweight alternative to the overloads. +The method provides a set of overloads that make it easy to start a task by using default values. It is a lightweight alternative to the overloads. ]]> @@ -4036,14 +4035,10 @@ This method is intended for compiler use rather than use directly in code. The method allows you to create and execute a task in a single method call and is a simpler alternative to the method. It creates a task with the following default values: - Its cancellation token is . - - Its property value is . - - It uses the default task scheduler. - For information on handling exceptions thrown by task operations, see [Exception Handling](/dotnet/standard/parallel-programming/exception-handling-task-parallel-library). - - +For information on handling exceptions thrown by task operations, see [Exception Handling](/dotnet/standard/parallel-programming/exception-handling-task-parallel-library). ## Examples The following example defines a `ShowThreadInfo` method that displays the of the current thread. It is called directly from the application thread, and is called from the delegate passed to the method. @@ -4197,13 +4192,10 @@ This method is intended for compiler use rather than use directly in code. The method is a simpler alternative to the method. It creates a task with the following default values: - Its property value is . - - It uses the default task scheduler. For information on handling exceptions thrown by task operations, see [Exception Handling](/dotnet/standard/parallel-programming/exception-handling-task-parallel-library). - - ## Examples The following example calls the method to create a task that iterates the files in the C:\Windows\System32 directory. The lambda expression calls the method to add information about each file to a object. Each detached nested task invoked by the loop checks the state of the cancellation token and, if cancellation is requested, calls the method. The method throws an exception that is handled in a `catch` block when the calling thread calls the method. @@ -4292,11 +4284,6 @@ This method is intended for compiler use rather than use directly in code. The task has been canceled. - - - Queues the specified work to run on the thread pool and returns a that represents that work. - - From 1ea986ef0dbde03be711c43b17c02a1dab16ad0a Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 1 Jul 2026 17:04:06 -0700 Subject: [PATCH 5/5] fix crefs --- .../Utf8+TryWriteInterpolatedStringHandler.xml | 2 +- .../StringBuilder+AppendInterpolatedStringHandler.xml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml b/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml index a168b2720bb..f796febbb55 100644 --- a/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml +++ b/xml/System.Text.Unicode/Utf8+TryWriteInterpolatedStringHandler.xml @@ -45,7 +45,7 @@ - Initializes a new instance of the class. + Initializes a new instance of the class. diff --git a/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml b/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml index b6c7479b2dc..851721d7c15 100644 --- a/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml +++ b/xml/System.Text/StringBuilder+AppendInterpolatedStringHandler.xml @@ -47,7 +47,7 @@ - Initializes a new instance of the class. + Initializes a new instance of the class.