diff --git a/xml/System.Data/DataSet.xml b/xml/System.Data/DataSet.xml index 0dbddeebc5a..3ff5d343cfd 100644 --- a/xml/System.Data/DataSet.xml +++ b/xml/System.Data/DataSet.xml @@ -319,7 +319,7 @@ The following example consists of several methods that, combined, create and fil Contextual information about the serialized stream. Initializes a new instance of the class with serialized data. To be added. - .NET 7 and later versions only: contains binary data. + contains binary data. @@ -389,7 +389,7 @@ The following example consists of several methods that, combined, create and fil ]]> - .NET 7 and later versions only: contains binary data. + contains binary data. @@ -5474,7 +5474,7 @@ class Program { Gets or sets the serialization format for the that's used during remoting. One of the enumeration values that specifies the serialization format. To be added. - .NET 7 and later versions only: The value being set is . + The value being set is . Using DataSets in ADO.NET diff --git a/xml/System.Data/DataTable.xml b/xml/System.Data/DataTable.xml index 736b90e2941..dcc31eda9bf 100644 --- a/xml/System.Data/DataTable.xml +++ b/xml/System.Data/DataTable.xml @@ -327,7 +327,7 @@ This sample demonstrates how to create a DataTable manually with specific schema Contextual information about the serialized stream. Initializes a new instance of the class with serialized data. To be added. - .NET 7 and later versions only: contains binary data. + contains binary data. DataTables @@ -5672,7 +5672,7 @@ public class A { Gets or sets the serialization format. One of the enumeration values that specifies the serialization format. To be added. - .NET 7 and later versions only: The value being set is . + The value being set is . DataTables diff --git a/xml/System.Data/SerializationFormat.xml b/xml/System.Data/SerializationFormat.xml index 1cf3d45bcee..683278c105b 100644 --- a/xml/System.Data/SerializationFormat.xml +++ b/xml/System.Data/SerializationFormat.xml @@ -48,7 +48,7 @@ ## Remarks -The `Binary` field is obsolete starting in .NET 7, because it relies on , which is inherently insecure. +The `Binary` field is obsolete, because it relies on , which is inherently insecure. The default format is `Xml`. This format is backward compatible and will work with all versions of .NET. @@ -99,7 +99,7 @@ The default format is `Xml`. This format is backward compatible and will work wi 1 - Serialize as binary content. This field is obsolete starting in .NET 7. + Serialize as binary content. This field is obsolete. diff --git a/xml/System.Diagnostics.Tracing/EventWrittenEventArgs.xml b/xml/System.Diagnostics.Tracing/EventWrittenEventArgs.xml index 2dff2850d5a..d94fd68bcd9 100644 --- a/xml/System.Diagnostics.Tracing/EventWrittenEventArgs.xml +++ b/xml/System.Diagnostics.Tracing/EventWrittenEventArgs.xml @@ -68,7 +68,7 @@ When using and it ## OSThreadId and TimeStamp properties -Starting with .NET Core 2.2, objects can subscribe to native runtime events (such as GC, JIT, and threadpool events) in addition to events emitted by objects. In previous versions of .NET Core and all versions of .NET Framework, the thread ID and timestamp can be gathered from the environment, because they are dispatched synchronously on the same thread that emitted them. Not all native runtime events can be dispatched synchronously, however. Some events, such as GC events, are emitted when managed thread execution is suspended. These events are buffered in native code and are dispatched by a dispatcher thread once managed code can execute again. Because these events are buffered, the environment cannot be used to reliably retrieve the thread ID and timestamp. Because of this, starting with .NET Core 2.2, thread ID and timestamp information are available as members of the `EventWrittenEventArgs` class. + objects can subscribe to native runtime events (such as GC, JIT, and threadpool events) in addition to events emitted by objects. Not all native runtime events can be dispatched synchronously, however. Some events, such as GC events, are emitted when managed thread execution is suspended. These events are buffered in native code and are dispatched by a dispatcher thread once managed code can execute again. Because these events are buffered, the environment cannot be used to reliably retrieve the thread ID and timestamp. Thread ID and timestamp information are available as members of the `EventWrittenEventArgs` class. ## RelatedActivityId property diff --git a/xml/System.Diagnostics/ActivityLink.xml b/xml/System.Diagnostics/ActivityLink.xml index 06cd55952cb..fa905c9774a 100644 --- a/xml/System.Diagnostics/ActivityLink.xml +++ b/xml/System.Diagnostics/ActivityLink.xml @@ -174,7 +174,7 @@ Activity links can be used to represent batched operations where an activity was ## Remarks - equality is currently undefined. The current behavior is that two instances with the same and no tags will return `true` for . Prior to .NET 7, instances sharing an instance and the same would return `true` for . Starting from .NET 7, will always return `false` when tags are used. This may change in the future. Exercise caution in calling this method. + equality is currently undefined. The current behavior is that two instances with the same and no tags return `true` for . returns `false` when tags are used. This might change in the future. Exercise caution when calling this method. ]]> @@ -219,7 +219,7 @@ Activity links can be used to represent batched operations where an activity was equality is currently undefined. The current behavior is that two instances with the same and no tags will return `true` for . Prior to .NET 7, instances sharing an instance and the same would return `true` for . Starting in .NET 7, always returns `false` when tags are used. + equality is currently undefined. The current behavior is that two instances with the same and no tags return `true` for . always returns `false` when tags are used. ]]> diff --git a/xml/System.Diagnostics/Debug.xml b/xml/System.Diagnostics/Debug.xml index 45dc4ecc277..3c15f2f6bfb 100644 --- a/xml/System.Diagnostics/Debug.xml +++ b/xml/System.Diagnostics/Debug.xml @@ -275,7 +275,7 @@ The following example creates an index for an array, performs some action to set ## Remarks -This overload was introduced in .NET 6 to improve performance. In comparison to the overloads that take a `String` parameter, this overload only evaluates any interpolated string formatting items if the message is required. +This overload has better performance than the overloads that take a `String` parameter. This overload only evaluates any interpolated string formatting items if the message is required. By default, the method works only in debug builds. Use the method if you want to do assertions in release builds. For more information, see [Assertions in Managed Code](/visualstudio/debugger/assertions-in-managed-code). @@ -470,7 +470,7 @@ The following example checks whether the `type` parameter is valid. If `type` is ## Remarks -This overload was introduced in .NET 6 to improve performance. In comparison to the overloads that take a `String` parameter, this overload only evaluates any interpolated string formatting items if the message is required. +This overload has better performance than the overloads that take a `String` parameter. This overload only evaluates any interpolated string formatting items if the message is required. By default, the method works only in debug builds. Use the method if you want to do assertions in release builds. For more information, see [Assertions in Managed Code](/visualstudio/debugger/assertions-in-managed-code). @@ -1957,7 +1957,7 @@ The following example creates a named `gen ## Remarks -This overload was introduced in .NET 6 to improve performance. In comparison to the overloads that take a `String` parameter, this overload only evaluates any interpolated string formatting items if the message is required. +This overload has better performance than the overloads that take a `String` parameter. This overload only evaluates any interpolated string formatting items if the message is required. By default, the output is written to an instance of . @@ -2235,7 +2235,7 @@ Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range"); ## Remarks -This overload was introduced in .NET 6 to improve performance. In comparison to the overloads that take a `String` parameter, this overload only evaluates any interpolated string formatting items if the message is required. +This overload has better performance than the overloads that take a `String` parameter. This overload only evaluates any interpolated string formatting items if the message is required. By default, the output is written to an instance of . @@ -2963,7 +2963,7 @@ The following example creates a named `gen ## Remarks -This overload was introduced in .NET 6 to improve performance. In comparison to the overloads that take a `String` parameter, this overload only evaluates any interpolated string formatting items if the message is required. +This overload has better performance than the overloads that take a `String` parameter. This overload only evaluates any interpolated string formatting items if the message is required. By default, the output is written to an instance of . @@ -3240,7 +3240,7 @@ Debug.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range") ## Remarks -This overload was introduced in .NET 6 to improve performance. In comparison to the overloads that take a `String` parameter, this overload only evaluates any interpolated string formatting items if the message is required. +This overload has better performance than the overloads that take a `String` parameter. This overload only evaluates any interpolated string formatting items if the message is required. By default, the output is written to an instance of . diff --git a/xml/System.Globalization/CompareOptions.xml b/xml/System.Globalization/CompareOptions.xml index 8be87d3b364..84a14c25618 100644 --- a/xml/System.Globalization/CompareOptions.xml +++ b/xml/System.Globalization/CompareOptions.xml @@ -70,12 +70,12 @@ options denote case sensitivity or necessity to ignore types of characters. diff --git a/xml/System.IO.Compression/BrotliStream.xml b/xml/System.IO.Compression/BrotliStream.xml index 419a6a1949d..602bd755caf 100644 --- a/xml/System.IO.Compression/BrotliStream.xml +++ b/xml/System.IO.Compression/BrotliStream.xml @@ -85,7 +85,7 @@ To be added. is . - .NET 7 and later: is not defined in the enumeration. + is not defined in the enumeration. @@ -193,7 +193,7 @@ To be added. is . - .NET 7 and later: is not defined in the enumeration. + is not defined in the enumeration. diff --git a/xml/System.IO.Compression/DeflateStream.xml b/xml/System.IO.Compression/DeflateStream.xml index 9c2ad4f46b0..34f4e65e00d 100644 --- a/xml/System.IO.Compression/DeflateStream.xml +++ b/xml/System.IO.Compression/DeflateStream.xml @@ -1319,7 +1319,7 @@ This method stores in the task it returns all non-usage exceptions that the meth [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). Use the property to determine whether the current instance supports reading. Use the method to read asynchronously from the current stream. @@ -1389,7 +1389,7 @@ Use for reading primitive data types. [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). The following example shows how to compress and decompress bytes by using the and methods. @@ -1460,7 +1460,7 @@ The following example shows how to compress and decompress bytes by using the [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). The `ReadAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in desktop apps where a time-consuming stream operation can block the UI thread and make the app appear as if it's not working. The async methods are used in conjunction with the `async` and `await` keywords in Visual Basic and C#. @@ -1526,7 +1526,7 @@ If the operation is canceled before it completes, the returned task contains the [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). The `ReadAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in desktop apps where a time-consuming stream operation can block the UI thread and make the app appear as if it's not working. The async methods are used in conjunction with the `async` and `await` keywords in Visual Basic and C#. diff --git a/xml/System.IO.Compression/GZipStream.xml b/xml/System.IO.Compression/GZipStream.xml index 7098729f3f8..3a7659c9870 100644 --- a/xml/System.IO.Compression/GZipStream.xml +++ b/xml/System.IO.Compression/GZipStream.xml @@ -504,7 +504,7 @@ By default, the compression level is set to [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). This method is available to support legacy code; however, you can implement asynchronous I/O operations more easily by using the newer async methods such as . For more information, see [Asynchronous file I/O](/dotnet/standard/io/asynchronous-file-i-o). @@ -1315,7 +1315,7 @@ This method stores in the task it returns all non-usage exceptions that the meth [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). Use the property to determine whether the current instance supports reading. Use the method to read asynchronously from the current stream. @@ -1387,7 +1387,7 @@ Use for reading primitive data types. ## Remarks > [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). If data is found in an invalid format, an is thrown. A cyclic redundancy check (CRC) is performed as one of the last operations of this method. @@ -1462,7 +1462,7 @@ The following example shows how to compress and decompress bytes by using the [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). The `ReadAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in desktop apps where a time-consuming stream operation can block the UI thread and make the app appear as if it's not working. The async methods are used in conjunction with the `async` and `await` keywords in Visual Basic and C#. @@ -1528,7 +1528,7 @@ If the operation is canceled before it completes, the returned task contains the [!IMPORTANT] -> Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). +> This method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). The `ReadAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in desktop apps where a time-consuming stream operation can block the UI thread and make the app appear as if it's not working. The async methods are used in conjunction with the `async` and `await` keywords in Visual Basic and C#. diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml index 9220eca72ab..9e169316940 100644 --- a/xml/System.Net.Http/HttpClient.xml +++ b/xml/System.Net.Http/HttpClient.xml @@ -54,9 +54,9 @@ The class instance acts as a session to send H ## Instancing - is intended to be instantiated once and reused throughout the life of an application. In .NET Core and .NET 5+, `HttpClient` pools connections inside the handler instance and reuses a connection across multiple requests. If you instantiate an `HttpClient` class for every request, the number of sockets available under heavy loads will be exhausted. This exhaustion will result in errors. + is intended to be instantiated once and reused throughout the life of an application. `HttpClient` pools connections inside the handler instance and reuses a connection across multiple requests. If you instantiate an `HttpClient` class for every request, the number of sockets available under heavy loads will be exhausted. This exhaustion will result in errors. -You can configure additional options by passing in a "handler", such as (or in .NET Core 2.1 or later), as part of the constructor. The connection properties on the handler cannot be changed once a request has been submitted, so one reason to create a new `HttpClient` instance would be if you need to change the connection properties. If different requests require different settings, this may also lead to an application having multiple instances, where each instance is configured appropriately, and then requests are issued on the relevant client. +You can configure additional options by passing in a "handler", such as or , as part of the constructor. The connection properties on the handler cannot be changed once a request has been submitted, so one reason to create a new `HttpClient` instance would be if you need to change the connection properties. If different requests require different settings, this may also lead to an application having multiple instances, where each instance is configured appropriately, and then requests are issued on the relevant client. `HttpClient` only resolves DNS entries when a connection is created. It does not track any time to live (TTL) durations specified by the DNS server. If DNS entries change regularly, which can happen in some container scenarios, the client won't respect those updates. To solve this issue, you can limit the lifetime of the connection by setting the property, so that DNS lookup is required when the connection is replaced. @@ -94,32 +94,21 @@ On each platform, tries to use the best availa | Windows/.NET Framework | | | Windows/Mono | | | Windows/UWP | Windows native (HTTP 2.0 capable) | -| Windows/.NET Core 1.0-2.0 | Windows native (HTTP 2.0 capable) | | macOS/Mono | | -| macOS/.NET Core 1.0-2.0 | `libcurl`-based HTTP transport (HTTP 2.0 capable) | | Linux/Mono | | -| Linux/.NET Core 1.0-2.0 | `libcurl`-based HTTP transport (HTTP 2.0 capable) | -| .NET Core 2.1 and later | | +| .NET | | Users can also configure a specific transport for by invoking the constructor that takes an . -### .NET Framework & Mono +The class provides the implementation used by higher-level HTTP networking classes such as . The use of offers a number of advantages: -By default on .NET Framework and Mono, is used to send requests to the server. This behavior can be modified by specifying a different handler in one of the constructor overloads with an parameter. If you require features like authentication or caching, you can use to configure settings and the instance can be passed to the constructor. The returned handler can be passed to a constructor overload that has an parameter. - -### .NET Core - -Starting with .NET Core 2.1, the class instead of provides the implementation used by higher-level HTTP networking classes such as . The use of offers a number of advantages: - -- A significant performance improvement when compared with the previous implementation. -- The elimination of platform dependencies, which simplifies deployment and servicing. For example, `libcurl` is no longer a dependency on .NET Core for macOS and .NET Core for Linux. +- High performance. +- The elimination of platform dependencies, which simplifies deployment and servicing. - Consistent behavior across all .NET platforms. -If this change is undesirable, on Windows you can continue to use by referencing its [NuGet package](https://www.nuget.org/packages/System.Net.Http.WinHttpHandler/) and passing it to [HttpClient's constructor](xref:System.Net.Http.HttpClient.%23ctor(System.Net.Http.HttpMessageHandler)) manually. - ## Configure behavior using runtime configuration options -Certain aspects of 's behavior are customizable through [Runtime configuration options](/dotnet/core/run-time-config/networking). However, the behavior of these switches differs through .NET versions. For example, in .NET Core 2.1 - 3.1, you can configure whether is used by default, but that option is no longer available starting in .NET 5. +Certain aspects of 's behavior are customizable through [Runtime configuration options](/dotnet/core/run-time-config/networking). ## Connection pooling @@ -716,7 +705,7 @@ This property has no effect on any of the object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -786,7 +775,7 @@ The is not an absolute URI. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -862,7 +851,7 @@ The is not an absolute URI. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -938,7 +927,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1081,7 +1070,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1144,7 +1133,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1212,7 +1201,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1281,7 +1270,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1350,7 +1339,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1414,7 +1403,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. The behavior is the same as if has been explicitly specified. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1488,7 +1477,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1559,7 +1548,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete based on the `completionOption` parameter after the part or all of the response (including content) is read. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1644,7 +1633,7 @@ The request failed due to timeout. In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -1713,7 +1702,7 @@ The response status code was outside of the range of 200-299 (which indicate suc In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, that nests a is thrown. +> In case of a timeout, an that nests a is thrown. ]]> @@ -1779,7 +1768,7 @@ The response status code was outside of the range of 200-299 (which indicate suc In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, that nests a is thrown. +> In case of a timeout, an that nests a is thrown. ]]> @@ -1845,7 +1834,7 @@ The request failed due to timeout. In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, that nests a is thrown. +> In case of a timeout, an that nests a is thrown. ]]> @@ -1934,7 +1923,7 @@ The request failed due to timeout. In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2003,7 +1992,7 @@ The response status code was outside of the range of 200-299 (which indicate suc In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2069,7 +2058,7 @@ The response status code was outside of the range of 200-299 (which indicate suc In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout: an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2136,7 +2125,7 @@ The response status code was outside of the range of 200-299 (which indicate suc In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2225,7 +2214,7 @@ The request failed due to timeout. In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2294,7 +2283,7 @@ The response status code was outside of the range of 200-299 (which indicate suc In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2360,7 +2349,7 @@ The response status code was outside of the range of 200-299 (which indicate suc In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2427,7 +2416,7 @@ The request failed due to timeout. In some scenarios, you might need more control over which status codes are considered to be successful; for example, an API might be expected to always return `200 OK`. In such cases, we recommend to manually check if matches the expected value. > [!NOTE] -> In case of a timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of a timeout, an that nests a is thrown. ]]> @@ -2822,7 +2811,7 @@ The size specified is greater than the maximum allowed buffer size. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -2887,7 +2876,7 @@ The size specified is greater than the maximum allowed buffer size. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -2960,7 +2949,7 @@ The size specified is greater than the maximum allowed buffer size. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -3031,7 +3020,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -3119,7 +3108,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -3184,7 +3173,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -3257,7 +3246,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> @@ -3328,7 +3317,7 @@ The request failed due to timeout. This operation doesn't block. The returned object will complete after the whole response (including content) is read. > [!NOTE] -> In case of timeout, an that nests a is thrown. (On .NET Core versions, without any inner exception is thrown.) +> In case of timeout, an that nests a is thrown. ]]> diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml index 30d162ae2b1..331be68f78d 100644 --- a/xml/System.Net.Http/HttpClientHandler.xml +++ b/xml/System.Net.Http/HttpClientHandler.xml @@ -52,7 +52,7 @@ The class and classes derived from it enable developers to configure a variety of options ranging from proxies to authentication. -Starting in .NET Core 2.1, the implementation of the `HttpClientHandler` class was changed to be based on the cross-platform HTTP protocol stack used by the class. Prior to .NET Core 2.1, the `HttpClientHandler` class used older HTTP protocol stacks ( on Windows and `CurlHandler`, an internal class implemented on top of Linux's native `libcurl` component, on Linux). +The implementation of the `HttpClientHandler` class is based on the cross-platform HTTP protocol stack used by the class. ]]> diff --git a/xml/System.Net.Http/SocketsHttpHandler.xml b/xml/System.Net.Http/SocketsHttpHandler.xml index 068255b8ec9..9725b28b807 100644 --- a/xml/System.Net.Http/SocketsHttpHandler.xml +++ b/xml/System.Net.Http/SocketsHttpHandler.xml @@ -949,7 +949,7 @@ For example, if the value is 64, then 65,536 bytes are allowed for the maximum r Gets or sets how long a connection can be idle in the pool to be considered reusable. - The maximum idle time for a connection in the pool. The default value for this property is 1 minute in .NET 6 and later versions; the default value is 2 minutes in .NET Core and .NET 5. + The maximum idle time for a connection in the pool. The default value for this property is 1 minute. To be added. The value specified is less than and is not . An operation has already been started on the current instance. diff --git a/xml/System.Net.Http/WinHttpHandler.xml b/xml/System.Net.Http/WinHttpHandler.xml index 543eddfe6be..39481ff321c 100644 --- a/xml/System.Net.Http/WinHttpHandler.xml +++ b/xml/System.Net.Http/WinHttpHandler.xml @@ -54,7 +54,7 @@ When using a chain of multiple handlers, should be at the bottom of the chain. -Starting in .NET 5, is no longer included in the *System.Net.Http.dll* assembly as part of the .NET runtime. For more information, see [WinHttpHandler removed from .NET runtime](/dotnet/core/compatibility/3.1-5.0#winhttphandler-removed-from-net-runtime). + isn't included in the *System.Net.Http.dll* assembly as part of the .NET runtime. For more information, see [WinHttpHandler removed from .NET runtime](/dotnet/core/compatibility/3.1-5.0#winhttphandler-removed-from-net-runtime). ### Trailing headers diff --git a/xml/System.Net.NetworkInformation/Ping.xml b/xml/System.Net.NetworkInformation/Ping.xml index 647b6ca26b2..ca4cc19ae93 100644 --- a/xml/System.Net.NetworkInformation/Ping.xml +++ b/xml/System.Net.NetworkInformation/Ping.xml @@ -740,7 +740,7 @@ A call to is in progress. An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. This object has been disposed. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -821,7 +821,7 @@ A call to is in progress. An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. This object has been disposed. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -910,7 +910,7 @@ A call to is in progress. An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. This object has been disposed. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -1064,7 +1064,7 @@ A call to is in progress. An exception was thrown while sending or receiving the ICMP messages. See the inner exception for the exact exception that was thrown. This object has been disposed. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -1569,7 +1569,7 @@ is not a valid IP address. This object has been disposed. The size of exceeds 65500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -1663,7 +1663,7 @@ could not be resolved to a valid IP address. This object has been disposed. The size of exceeds 65500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -1772,7 +1772,7 @@ is not a valid IP address. This object has been disposed. The size of exceeds 65500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -1879,7 +1879,7 @@ could not be resolved to a valid IP address. This object has been disposed. The size of exceeds 65500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -2249,7 +2249,7 @@ The IP address returned by any of the is not a valid IP address. This object has been disposed. The size of exceeds 65,500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -2320,7 +2320,7 @@ The IP address returned by any of the could not be resolved to a valid IP address. This object has been disposed. The size of exceeds 65500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -2397,7 +2397,7 @@ The IP address returned by any of the is not a valid IP address. This object has been disposed. The size of exceeds 65,500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. @@ -2478,7 +2478,7 @@ The IP address returned by any of the could not be resolved to a valid IP address. This object has been disposed. The size of exceeds 65500 bytes. - .NET 7 and later versions only on Linux: The process is non-privileged, and is not empty. + On Linux: The process is non-privileged, and is not empty. diff --git a/xml/System.Net.Security/EncryptionPolicy.xml b/xml/System.Net.Security/EncryptionPolicy.xml index e879f1b2803..2ae0f8d51eb 100644 --- a/xml/System.Net.Security/EncryptionPolicy.xml +++ b/xml/System.Net.Security/EncryptionPolicy.xml @@ -100,7 +100,7 @@ The can be set to require, allow, or 1 - Prefer that full encryption be used, but allow a NULL cipher (no encryption) if the server agrees. Starting in .NET 7, this member is obsolete. + Prefer that full encryption be used, but allow a NULL cipher (no encryption) if the server agrees. This member is obsolete. @@ -146,7 +146,7 @@ The can be set to require, allow, or 2 - Allow no encryption and request that a NULL cipher be used if the other endpoint can handle a NULL cipher. Starting in .NET 7, this member is obsolete. + Allow no encryption and request that a NULL cipher be used if the other endpoint can handle a NULL cipher. This member is obsolete. diff --git a/xml/System.Net.Security/SslCertificateTrust.xml b/xml/System.Net.Security/SslCertificateTrust.xml index 639ecea978b..8a7d643d2ea 100644 --- a/xml/System.Net.Security/SslCertificateTrust.xml +++ b/xml/System.Net.Security/SslCertificateTrust.xml @@ -69,9 +69,9 @@ ## Remarks -If the `sendTrustInHandshake` argument is `true`, the client can use the list of trusted certificate authorities from the server to select an appropriate client certificate. Sending trusted issuers list is not supported for `SslCertificateTrust` instances created using the `SslCertificaetTrust.CreateForX509Collection` in .NET 6. +If the `sendTrustInHandshake` argument is `true`, the client can use the list of trusted certificate authorities from the server to select an appropriate client certificate. -Since .NET 7, the sending trusted issuers list is supported on Linux and OSX platforms. +The sending trusted issuers list is supported on Linux and macOS platforms. > [!WARNING] > The list of trusted CAs increases the size of the handshake message. It could also be viewed as an information leak about the system's configuration. For these reasons, we recommend setting `sendTrustInHandshake` to `false`. @@ -117,7 +117,7 @@ Since .NET 7, the sending trusted issuers list is supported on Linux and OSX pla ## Remarks -If the `sendTrustInHandshake` argument is `true`, the client can use the list of trusted certificate authorities from the server to select an appropriate client certificate. In .NET 6, the list is only sent on Windows, and it depends on the "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\SendTrustedIssuerList" registry setting being set to 1. Since .NET 7, the list is sent on Linux and OSX platforms as well. +If the `sendTrustInHandshake` argument is `true`, the client can use the list of trusted certificate authorities from the server to select an appropriate client certificate. > [!WARNING] > The list of trusted CAs increases the size of the handshake message. It could also be viewed as an information leak about the system's configuration. For these reasons, we recommend setting `sendTrustInHandshake` to `false`. diff --git a/xml/System.Net.Security/SslClientAuthenticationOptions.xml b/xml/System.Net.Security/SslClientAuthenticationOptions.xml index 23464a9152f..da07a99ec6c 100644 --- a/xml/System.Net.Security/SslClientAuthenticationOptions.xml +++ b/xml/System.Net.Security/SslClientAuthenticationOptions.xml @@ -598,7 +598,7 @@ When this property isn't `null`, certain properties on `SslClientAuthenticationO Gets or sets the name of the server the client is trying to connect to. The name is used for server certificate validation and can be a DNS name or an IP address. - The name of the server the client is trying to connect to. If set to (.NET 7 and later versions only) or an empty string, the client doesn't send the host name in the Server Name Indication extension. + The name of the server the client is trying to connect to. If set to or an empty string, the client doesn't send the host name in the Server Name Indication extension. If the value is or an empty string, you should also provide a and validate the subject of the server's certificate. diff --git a/xml/System.Net.Sockets/MulticastOption.xml b/xml/System.Net.Sockets/MulticastOption.xml index d7085480b05..1c9afc2de3a 100644 --- a/xml/System.Net.Sockets/MulticastOption.xml +++ b/xml/System.Net.Sockets/MulticastOption.xml @@ -299,7 +299,7 @@ ]]> - .NET 5 and later versions: The value to set is . + The value to set is . diff --git a/xml/System.Net.Sockets/Socket.xml b/xml/System.Net.Sockets/Socket.xml index c9117dc64a5..ac9a3165708 100644 --- a/xml/System.Net.Sockets/Socket.xml +++ b/xml/System.Net.Sockets/Socket.xml @@ -875,7 +875,7 @@ This method populates the instance with data ga The operation must be completed by calling the method. Typically, the method is invoked by the provided delegate. will block the calling thread until the operation is completed. - To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > You can use the property of the returned to identify the remote host's network address and port number. @@ -970,7 +970,7 @@ This method populates the instance with data ga The operation must be completed by calling the method. Typically, the method is invoked by the provided delegate. will block the calling thread until the operation is completed. - To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > You can use the property of the returned to identify the remote host's network address and port number. @@ -1069,7 +1069,7 @@ This method populates the instance with data ga The operation must be completed by calling the method. Typically, the method is invoked by the provided delegate. will block the calling thread until the operation is completed. - To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > You can use the property of the returned to identify the remote host's network address and port number. @@ -1180,7 +1180,7 @@ This method populates the instance with data ga The operation must be completed by calling the method. Typically, the method is invoked by the provided delegate. will block the calling thread until the operation is completed. - To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > You can use the property of the returned to identify the remote host's network address and port number. @@ -1290,7 +1290,7 @@ This method populates the instance with data ga If you are using a connection-oriented protocol and do not call before calling , the underlying service provider will assign the most appropriate local network address and port number. If you are using a connectionless protocol, the service provider will not assign a local network address and port number until you call the or method. If you want to change the default remote host, call the method again with the desired endpoint. - To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > If you receive a , use the property to obtain the specific error code. @@ -1402,7 +1402,7 @@ This method populates the instance with data ga If you are using a connection-oriented protocol and do not call before calling , the underlying service provider will assign the most appropriate local network address and port number. If you are using a connectionless protocol, the service provider will not assign a local network address and port number until you call the or method. If you want to change the default remote host, call the method again with the desired endpoint. - To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > If you receive a , use the property to obtain the specific error code. @@ -1514,7 +1514,7 @@ This method populates the instance with data ga If you are using a connection-oriented protocol and do not call before calling , the underlying service provider will assign the most appropriate local network address and port number. If you are using a connectionless protocol, the service provider will not assign a local network address and port number until you call the or method. If you want to change the default remote host, call the method again with the desired endpoint. - To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + To cancel a pending call to the method, close the . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > If you receive a , use the property to obtain the specific error code. @@ -1701,7 +1701,7 @@ This method populates the instance with data ga The asynchronous operation must be completed by calling the method. Typically, the method is invoked by the delegate. will block the calling thread until the operation is completed. - Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > If you receive a , use the property to obtain the specific error code. @@ -1802,7 +1802,7 @@ This method populates the instance with data ga The asynchronous operation must be completed by calling the method. Typically, the method is invoked by the delegate. will block the calling thread until the operation is completed. - Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > If you receive a , use the property to obtain the specific error code. @@ -1913,7 +1913,7 @@ This method populates the instance with data ga The asynchronous operation must be completed by calling the method. Typically, the method is invoked by the delegate. will block the calling thread until the operation is completed. - Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > If you receive a , use the property to obtain the specific error code. @@ -2032,7 +2032,7 @@ This method populates the instance with data ga The asynchronous operation must be completed by calling the method. Typically, the method is invoked by the delegate. will block the calling thread until the operation is completed. - Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw an (before .NET 7) or a (on .NET 7+) to indicate that the operation has been cancelled. + Close the to cancel a pending . When the method is called while an asynchronous operation is in progress, the callback provided to the method is called. A subsequent call to the method will throw a to indicate that the operation has been cancelled. > [!NOTE] > If you receive a , use the property to obtain the specific error code. @@ -4922,7 +4922,7 @@ Do not call the - .NET Core on any OS and .NET 5+ on Unix-based OS only: The current platform is not supported. + Unix-based OS only: The current platform is not supported. is not a valid process id. @@ -5067,7 +5067,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. method was previously called. @@ -5150,7 +5150,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5228,7 +5228,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5300,7 +5300,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5374,7 +5374,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. The disconnect request has timed out. @@ -5458,7 +5458,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5542,7 +5542,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5624,7 +5624,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5705,7 +5705,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5793,7 +5793,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5882,7 +5882,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -5961,7 +5961,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -6036,7 +6036,7 @@ Duplication of the socket reference failed. -or- -.NET 7+ only: The has been closed. +The has been closed. @@ -10393,7 +10393,7 @@ You must call the Bind method before performing this operation. The , , and parameters are all or empty. At least one of , , or must contain at least one . An error occurred when attempting to access the socket. - .NET 5 and later: One or more sockets are disposed. + One or more sockets are disposed. diff --git a/xml/System.Numerics/Vector2.xml b/xml/System.Numerics/Vector2.xml index 2b881cbdb69..6ed4bcd4563 100644 --- a/xml/System.Numerics/Vector2.xml +++ b/xml/System.Numerics/Vector2.xml @@ -2806,7 +2806,7 @@ ## Remarks -The behavior of this method changed in .NET 5. For more information, see [Behavior change for Vector2.Lerp and Vector4.Lerp](/dotnet/core/compatibility/3.1-5.0#behavior-change-for-vector2lerp-and-vector4lerp). +For more information about the behavior of this method, see [Behavior change for Vector2.Lerp and Vector4.Lerp](/dotnet/core/compatibility/3.1-5.0#behavior-change-for-vector2lerp-and-vector4lerp). ]]> diff --git a/xml/System.Numerics/Vector4.xml b/xml/System.Numerics/Vector4.xml index 6cbe9b1de74..7df6a2cc8a1 100644 --- a/xml/System.Numerics/Vector4.xml +++ b/xml/System.Numerics/Vector4.xml @@ -2966,7 +2966,7 @@ ## Remarks -The behavior of this method changed in .NET 5. For more information, see [Behavior change for Vector2.Lerp and Vector4.Lerp](/dotnet/core/compatibility/3.1-5.0#behavior-change-for-vector2lerp-and-vector4lerp). +The behavior of this method has changed. For more information, see [Behavior change for Vector2.Lerp and Vector4.Lerp](/dotnet/core/compatibility/3.1-5.0#behavior-change-for-vector2lerp-and-vector4lerp). ]]> diff --git a/xml/System.Numerics/Vector`1.xml b/xml/System.Numerics/Vector`1.xml index db8cfe4be38..f507dc7da63 100644 --- a/xml/System.Numerics/Vector`1.xml +++ b/xml/System.Numerics/Vector`1.xml @@ -153,7 +153,7 @@ The type `T` can be any of the following numeric types: did not contain at least elements. - .NET 5 and later: Type is not supported. + Type is not supported. The length of is less than sizeof(). @@ -205,7 +205,7 @@ The type `T` can be any of the following numeric types: did not contain at least elements. - .NET 5 and later: Type is not supported. + Type is not supported. The length of is less than . @@ -265,7 +265,7 @@ The type `T` can be any of the following numeric types: did not contain at least elements. - .NET 5 and later: Type is not supported. + Type is not supported. The length of is less than . @@ -305,7 +305,7 @@ The type `T` can be any of the following numeric types: The numeric type that defines the type of the components in the vector. Creates a vector whose components are of a specified type. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -354,7 +354,7 @@ The type `T` can be any of the following numeric types: is . - .NET 5 and later: Type is not supported. + Type is not supported. is . The length of is less than . @@ -414,7 +414,7 @@ The type `T` can be any of the following numeric types: -or- The length of minus is less than . - .NET 5 and later: Type is not supported. + Type is not supported. is . The length of , starting from , is less than . @@ -500,7 +500,7 @@ The type `T` can be any of the following numeric types: Copies the vector to the given . To be added. The number of elements in the source vector is greater than those available in the destination span. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -552,7 +552,7 @@ The type `T` can be any of the following numeric types: Copies the vector to the given span. . To be added. The number of elements in the source vector is greater than those available in the destination span. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -610,7 +610,7 @@ The type `T` can be any of the following numeric types: is . The number of elements in the current vector is greater than the number of elements available in the array. - .NET 5 and later: Type is not supported. + Type is not supported. is . @@ -674,7 +674,7 @@ The type `T` can be any of the following numeric types: The number of elements in the current instance is greater than the number of elements available from to the end of the array. is less than zero or greater than the last index in . - .NET 5 and later: Type is not supported. + Type is not supported. is . @@ -719,7 +719,7 @@ The type `T` can be any of the following numeric types: -or- -.NET 5 and later: Type is not supported. +Type is not supported. @@ -792,7 +792,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -857,7 +857,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -903,7 +903,7 @@ The type `T` can be any of the following numeric types: Returns the hash code for this instance. The hash code. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1025,7 +1025,7 @@ The type `T` can be any of the following numeric types: -or- is greater than or equal to . - .NET 5 and later: Type is not supported. + Type is not supported. was less than zero or greater than the number of elements. @@ -1072,7 +1072,7 @@ The type `T` can be any of the following numeric types: Returns a vector containing all ones. A vector containing all ones. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1144,7 +1144,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1216,7 +1216,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1288,7 +1288,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1365,7 +1365,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1478,7 +1478,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1550,7 +1550,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1612,7 +1612,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1669,7 +1669,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1726,7 +1726,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1783,7 +1783,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1840,7 +1840,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -1947,7 +1947,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2004,7 +2004,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2067,7 +2067,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2130,7 +2130,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2193,7 +2193,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2303,7 +2303,7 @@ The type `T` can be any of the following numeric types: if any element pairs in left and right are not equal. if all element pairs are equal. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2426,7 +2426,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2491,7 +2491,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2556,7 +2556,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2612,7 +2612,7 @@ The type `T` can be any of the following numeric types: Returns a new vector whose elements are obtained by taking the one's complement of a specified vector's elements. The one's complement vector. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2730,7 +2730,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2793,7 +2793,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -2944,7 +2944,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -3012,7 +3012,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -3087,7 +3087,7 @@ The type `T` can be any of the following numeric types: ]]> - .NET 5 and later: Type is not supported. + Type is not supported. @@ -3137,7 +3137,7 @@ The type `T` can be any of the following numeric types: if the source vector was successfully copied to . if is not large enough to hold the source vector. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -3190,7 +3190,7 @@ The type `T` can be any of the following numeric types: if the source vector was successfully copied to . if is not large enough to hold the source vector. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. @@ -3235,7 +3235,7 @@ The type `T` can be any of the following numeric types: Returns a vector containing all zeroes. A vector containing all zeroes. To be added. - .NET 5 and later: Type is not supported. + Type is not supported. diff --git a/xml/ns-System.Web.xml b/xml/ns-System.Web.xml index 12e3bc692e9..ecb85ede1e3 100644 --- a/xml/ns-System.Web.xml +++ b/xml/ns-System.Web.xml @@ -1,10 +1,6 @@ - For .NET Core and .NET 5+, this namespace contains the class. - -For .NET Framework, this namespace contains classes and interfaces that enable browser-server communication. These classes include the class, which provides extensive information about the current HTTP request; the class, which manages HTTP output to the client; -and the class, which provides access to server-side utilities and processes. also includes classes for cookie manipulation, file transfer, exception information, and output cache control in .NET Framework. - + To be added. To be added.