diff --git a/.github/ISSUE_TEMPLATE/z-customer-feedback.yml b/.github/ISSUE_TEMPLATE/z-customer-feedback.yml index 3c785ba85ea..2c4da23ce1f 100644 --- a/.github/ISSUE_TEMPLATE/z-customer-feedback.yml +++ b/.github/ISSUE_TEMPLATE/z-customer-feedback.yml @@ -22,7 +22,6 @@ body: validations: required: true - type: textarea - id: feedback validations: required: true attributes: diff --git a/.github/policies/close-issues.yml b/.github/policies/close-issues.yml index 48629f242ff..c909a3b4efb 100644 --- a/.github/policies/close-issues.yml +++ b/.github/policies/close-issues.yml @@ -35,7 +35,7 @@ configuration: - removeLabel: label: needs-more-info triggerOnOwnActions: true - + - description: Close issues labeled 'code-of-conduct' if: - payloadType: Issues @@ -43,57 +43,3 @@ configuration: label: code-of-conduct then: - closeIssue - - - description: Close learn template issues with empty descriptions (spam). - if: - - payloadType: Issues - - or: - - bodyContains: - pattern: '### Description[\n\r]+\[Enter feedback here\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Escriba sus comentarios aquí\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Tapez vos commentaires ici\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Hier Feedback eingeben\][\n\r]+###' - isRegex: true - - bodyContains: - pattern: '### Description[\n\r]+\[Geri bildiriminizi buraya girin\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Ketikkan umpan balik di sini\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Immetti qui i commenti\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Voer hier feedback in\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Insira comentários aqui\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Введите отзыв здесь\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[اكتب ملاحظاتك هنا\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[在此处输入反馈\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[여기에 피드백 입력\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[フィードバックをこちらに入力してください\][\n\r]+###' - isRegex: True - - bodyContains: - pattern: '### Description[\n\r]+\[Skriv din feedback här\][\n\r]+###' - then: - - addLabel: 'needs-more-info' - - addReply: - reply: This issue has been automatically closed due to an empty issue description from the original author. Feel free to reopen it if you have more information that can help us investigate the issue further. - - closeIssue 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..49b8527417a 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 might be exhausted. This exhaustion results 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/System.Reflection/Assembly.xml b/xml/System.Reflection/Assembly.xml index 541a86211b8..cd5758dcdb7 100644 --- a/xml/System.Reflection/Assembly.xml +++ b/xml/System.Reflection/Assembly.xml @@ -1656,7 +1656,7 @@ Many members of the class provide information The `name` argument should not include the path to the file. -In .NET 5 and later versions, for bundled assemblies, this method throws an exception. +For bundled assemblies, this method throws an exception. ]]> @@ -3329,7 +3329,7 @@ If there are assembly-qualified generic type parameters in the type name string, Gets a value indicating whether the assembly was loaded from the global assembly cache (.NET Framework only). in all cases. - This property is marked obsolete starting in .NET 5, and generates a compile-time warning. + This property is marked obsolete and generates a compile-time warning. diff --git a/xml/System.Runtime.InteropServices/DllImportAttribute.xml b/xml/System.Runtime.InteropServices/DllImportAttribute.xml index 7ef58fbc814..89aebc9964a 100644 --- a/xml/System.Runtime.InteropServices/DllImportAttribute.xml +++ b/xml/System.Runtime.InteropServices/DllImportAttribute.xml @@ -584,7 +584,7 @@ For additional information about using the platform invoke service to access fun `true` to indicate that the callee will set an error via `SetLastError` on Windows or `errno` on other platforms; otherwise, `false`. The default is `false`. If this field is set to `true`, the runtime marshaler calls `GetLastError` or `errno` and caches the value returned to prevent it from being overwritten by other API calls. - On .NET 6 and later, you can retrieve the error code by calling . On earlier .NET versions, call . + You can retrieve the error code by calling . The error information is cleared (set to `0`) before invoking the callee when this field is set to `true`. This means that error information returned by and represents only the error information from the last p/invoke with set to `true`. diff --git a/xml/System.Runtime.InteropServices/Marshal.xml b/xml/System.Runtime.InteropServices/Marshal.xml index 8eeb08e3766..b12a702da24 100644 --- a/xml/System.Runtime.InteropServices/Marshal.xml +++ b/xml/System.Runtime.InteropServices/Marshal.xml @@ -277,7 +277,7 @@ ## Remarks > [!IMPORTANT] -> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On .NET 6 and later, use the class on all platforms to allocate native memory. +> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. Use the class on all platforms to allocate native memory. is one of two memory allocation methods in the class. ( is the other.) This method exposes the Win32 [LocalAlloc](https://learn.microsoft.com/windows/win32/api/winbase/nf-winbase-localalloc) function from Kernel32.dll. @@ -353,7 +353,7 @@ ## Remarks > [!IMPORTANT] -> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On .NET 6 and later versions, use the class on all platforms to allocate native memory. +> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. Use the class on all platforms to allocate native memory. is one of two memory allocation methods in the class. ( is the other.) This method exposes the Win32 [LocalAlloc](https://learn.microsoft.com/windows/win32/api/winbase/nf-winbase-localalloc) function from Kernel32.dll. @@ -2580,7 +2580,7 @@ ## Remarks > [!IMPORTANT] -> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. On .NET 6 and later versions, use the class on all platforms to allocate native memory. +> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. Use the class on all platforms to allocate native memory. You can use to free any memory from the global heap allocated by , , or any equivalent unmanaged API method. If the `hglobal` parameter is the method does nothing. @@ -4314,7 +4314,7 @@ You can use this method to obtain error codes only if you apply the , which is named to better reflect the intent of the API and its cross-platform nature. On .NET 6 and later versions, prefer over . +This method is functionally equivalent to , which is named to better reflect the intent of the API and its cross-platform nature. Prefer over . ## Examples The following example calls the `GetLastWin32Error` method. The example first demonstrates calling the method with no error present and then demonstrates calling the method with an error present. @@ -8052,7 +8052,7 @@ This method is functionally equivalent to [!IMPORTANT] -> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. For .NET 6 and later, use the class instead to allocate native memory. On earlier targets where is unavailable, continue to use the appropriate allocation APIs. +> This native memory allocator is a legacy API that should be used exclusively when called for by specific Win32 APIs on the Windows platform. Use the class instead to allocate native memory. is one of two memory reallocation API methods in the class. ( is the other.) diff --git a/xml/System.Runtime.InteropServices/NativeLibrary.xml b/xml/System.Runtime.InteropServices/NativeLibrary.xml index f19e56e5c6e..e7b8f7cc129 100644 --- a/xml/System.Runtime.InteropServices/NativeLibrary.xml +++ b/xml/System.Runtime.InteropServices/NativeLibrary.xml @@ -216,7 +216,7 @@ Calling this method with an invalid `handle` parameter other than on the calling assembly, if any are present, are used. This method does not invoke the resolver registered using -method. Starting with .NET 5, this method does invoke the method and the event. +method. This method invokes the method and the event. ]]> diff --git a/xml/System.Runtime.InteropServices/RuntimeInformation.xml b/xml/System.Runtime.InteropServices/RuntimeInformation.xml index 4432c56bce8..2224957bfd7 100644 --- a/xml/System.Runtime.InteropServices/RuntimeInformation.xml +++ b/xml/System.Runtime.InteropServices/RuntimeInformation.xml @@ -214,7 +214,7 @@ The property returns a string that indicates the name of the currently executing The returned value is intended to represent the actual architecture of the underlying operating system. It's a best effort to ignore the architecture emulation infrastructure that might be involved to run the process. The returned value takes into account emulation built into Windows and macOS operating systems. The returned value does not take into account emulation using QEMU that's typically used on Linux. > [!NOTE] -> The behavior of this property for emulated processes changed, starting in .NET 7. For more information, see [RuntimeInformation.OSArchitecture under emulation](/dotnet/core/compatibility/interop/7.0/osarchitecture-emulation). +> For more information about the behavior of this property for emulated processes, see [RuntimeInformation.OSArchitecture under emulation](/dotnet/core/compatibility/interop/7.0/osarchitecture-emulation). ]]> diff --git a/xml/System.Runtime.Loader/AssemblyLoadContext.xml b/xml/System.Runtime.Loader/AssemblyLoadContext.xml index 3610fd32473..66d74bed742 100644 --- a/xml/System.Runtime.Loader/AssemblyLoadContext.xml +++ b/xml/System.Runtime.Loader/AssemblyLoadContext.xml @@ -50,7 +50,6 @@ The exists primarily to provide > [!NOTE] > > * does not provide any security features. All code has full permissions of the process. -> * In .NET Core 2.0 - 2.2 only, is an abstract class. To create a concrete class in these versions, implement the method. ## Usage in the runtime diff --git a/xml/System.Security.Authentication/SslProtocols.xml b/xml/System.Security.Authentication/SslProtocols.xml index 0741f1410f8..49ec232bc43 100644 --- a/xml/System.Security.Authentication/SslProtocols.xml +++ b/xml/System.Security.Authentication/SslProtocols.xml @@ -310,7 +310,7 @@ 192 - Specifies the TLS 1.0 security protocol. TLS 1.0 is provided for backward compatibility only. The TLS protocol is defined in IETF RFC 2246. This member is obsolete starting in .NET 7. + Specifies the TLS 1.0 security protocol. TLS 1.0 is provided for backward compatibility only. The TLS protocol is defined in IETF RFC 2246. This member is obsolete. @@ -356,7 +356,7 @@ 768 - Specifies the TLS 1.1 security protocol. The TLS protocol is defined in IETF RFC 4346. This member is obsolete starting in .NET 7. + Specifies the TLS 1.1 security protocol. The TLS protocol is defined in IETF RFC 4346. This member is obsolete. diff --git a/xml/System.Security.Cryptography/AesCng.xml b/xml/System.Security.Cryptography/AesCng.xml index f8de1dfa586..c5412d01b14 100644 --- a/xml/System.Security.Cryptography/AesCng.xml +++ b/xml/System.Security.Cryptography/AesCng.xml @@ -390,7 +390,7 @@ This method decrypts an encrypted message created using the - .NET 6 and later: CFB128 mode is selected and the key is persisted. + CFB128 mode is selected and the key is persisted. @@ -529,7 +529,7 @@ Use this method to encrypt a message and then use the - .NET 6 and later: CFB128 mode is selected and the key is persisted. + CFB128 mode is selected and the key is persisted. diff --git a/xml/System.Security.Cryptography/CryptoStream.xml b/xml/System.Security.Cryptography/CryptoStream.xml index d2138ab361c..4320e732b47 100644 --- a/xml/System.Security.Cryptography/CryptoStream.xml +++ b/xml/System.Security.Cryptography/CryptoStream.xml @@ -1343,7 +1343,7 @@ This property exists only to support inheritance from , a The maximum number of bytes to be read from the current stream. Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read. The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero if the end of the stream has been reached. - 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. + 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. The associated with current object does not match the underlying stream. For example, this exception is thrown when using with an underlying stream that is write only. or is less than zero. @@ -1390,7 +1390,7 @@ This property exists only to support inheritance from , a The token to monitor for cancellation requests. The default value is . Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. A task that represents the asynchronous read operation. The value of its property contains the total number of bytes read into the buffer. The result value can be less than the number of bytes allocated in the buffer if that many bytes are not currently available, or it can be 0 (zero) if the end of the stream has been reached. - 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. + 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. The associated with the current object does not match the underlying stream. For example, this exception is thrown when using with an underlying stream that's write only. The cancellation token was canceled. This exception is stored into the returned task. @@ -1451,7 +1451,7 @@ This property exists only to support inheritance from , a [!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). You must preface your call to with the `await` (C#) or `Await` (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see [Asynchronous programming (C#)](/dotnet/csharp/asynchronous-programming/) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). diff --git a/xml/System.Security.Cryptography/FromBase64Transform.xml b/xml/System.Security.Cryptography/FromBase64Transform.xml index 959c531303e..be0f3ca3124 100644 --- a/xml/System.Security.Cryptography/FromBase64Transform.xml +++ b/xml/System.Security.Cryptography/FromBase64Transform.xml @@ -284,8 +284,7 @@ Gets a value that indicates whether multiple blocks can be transformed. A value that indicates whether multiple blocks can be transformed. - Prior to .NET 5, only one block can be transformed at a time, so this property returns . - Starting in .NET 5, multiple blocks can be transformed, so this property returns . + Multiple blocks can be transformed, so this property returns . Cryptographic Services diff --git a/xml/System.Security.Cryptography/Oid.xml b/xml/System.Security.Cryptography/Oid.xml index 384363b3f4b..3a690ab1fc4 100644 --- a/xml/System.Security.Cryptography/Oid.xml +++ b/xml/System.Security.Cryptography/Oid.xml @@ -362,7 +362,7 @@ If one property is set to a known value, the value of the other property is updated automatically to a corresponding value. For example, if the property is set to "Secure Email", the property is set automatically to "1.3.6.1.5.5.7.3.4". -In .NET 5 and later versions, this property is *init only*, meaning that its value can't be changed once it's been set. +This property is *init only*, meaning that its value can't be changed once it's been set. ## Examples The following code example shows how to use the class. @@ -372,7 +372,7 @@ In .NET 5 and later versions, this property is *init only*, meaning that its val ]]> - .NET 5 and later: An attempt is made to set the value and the value has previously been set. + An attempt is made to set the value and the value has previously been set. @@ -531,7 +531,7 @@ In .NET 5 and later versions, this property is *init only*, meaning that its val If one property is set to a known value, the value of the other property is updated automatically to a corresponding value. For example, if the property is set to "1.3.6.1.5.5.7.3.4", the property is set automatically to "Secure Email". -In .NET 5 and later versions, this property is *init only*, meaning that its value can't be changed once it's been set. +This property is *init only*, meaning that its value can't be changed once it's been set. ## Examples The following code example shows how to use the class. @@ -541,7 +541,7 @@ In .NET 5 and later versions, this property is *init only*, meaning that its val ]]> - .NET 5 and later: An attempt is made to set the value and the value has previously been set. + An attempt is made to set the value and the value has previously been set. diff --git a/xml/System.Security.Cryptography/TripleDESCng.xml b/xml/System.Security.Cryptography/TripleDESCng.xml index 29c7b4ab347..2dea1c94b9f 100644 --- a/xml/System.Security.Cryptography/TripleDESCng.xml +++ b/xml/System.Security.Cryptography/TripleDESCng.xml @@ -358,7 +358,7 @@ ]]> - .NET 6 and later: CFB64 mode is selected and the key is persisted. + CFB64 mode is selected and the key is persisted. @@ -496,7 +496,7 @@ ]]> - .NET 6 and later: CFB64 mode is selected and the key is persisted. + CFB64 mode is selected and the key is persisted. diff --git a/xml/System.Text.Json.Serialization/JsonIncludeAttribute.xml b/xml/System.Text.Json.Serialization/JsonIncludeAttribute.xml index fd424a5626a..6b7b4339c12 100644 --- a/xml/System.Text.Json.Serialization/JsonIncludeAttribute.xml +++ b/xml/System.Text.Json.Serialization/JsonIncludeAttribute.xml @@ -43,8 +43,6 @@ When applied to a property, this attribute indicates that non-public *getters* a > - `protected`, `protected internal`, or `private protected` when the generated context is in a class that derives from the type. > - `private` if the type is nested in the same class as the generated context. -In .NET 6 and .NET 7, non-public properties aren't supported. - ]]> diff --git a/xml/System.Text.Json/Utf8JsonReader.xml b/xml/System.Text.Json/Utf8JsonReader.xml index 3b1505f769e..fa33b9a89ec 100644 --- a/xml/System.Text.Json/Utf8JsonReader.xml +++ b/xml/System.Text.Json/Utf8JsonReader.xml @@ -1025,7 +1025,7 @@ The JSON token value represents a number less than argument's property is greater than 4294967294 on .NET 6 and later versions, or Int32.MaxValue on all previous versions. + The argument's property is greater than 4294967294. @@ -2952,7 +2952,7 @@ Task t Status: RanToCompletion, Result: 42 -or- - The argument's property is greater than 4294967294 on .NET 6 and later versions, or Int32.MaxValue on all previous versions. + The argument's property is greater than 4294967294. The task has been canceled. This exception is stored into the returned task. The provided has already been disposed. The task has been canceled. @@ -3598,7 +3598,7 @@ This method creates a object whose property. -Starting in .NET 6, for some `TResult` types and some result values, this method may return a cached singleton object rather than allocating a new object. +For some `TResult` types and some result values, this method might return a cached singleton object rather than allocating a new object. ## Examples The following example is a command-line utility that calculates the number of bytes in the files in each directory whose name is passed as a command-line argument. Rather than executing a longer code path that instantiates a object and retrieves the value of its property for each file in the directory, the example simply calls the method to create a task whose property is zero (0) if a directory has no files. diff --git a/xml/System.Threading/ReaderWriterLockSlim.xml b/xml/System.Threading/ReaderWriterLockSlim.xml index d7f185c9b87..4664add4995 100644 --- a/xml/System.Threading/ReaderWriterLockSlim.xml +++ b/xml/System.Threading/ReaderWriterLockSlim.xml @@ -56,9 +56,7 @@ Use to protect a resource that is read by multiple threads and written to by one thread at a time. allows multiple threads to be in read mode, allows one thread to be in write mode with exclusive ownership of the lock, and allows one thread that has read access to be in upgradeable read mode, from which the thread can upgrade to write mode without having to relinquish its read access to the resource. > [!NOTE] -> -> - is similar to , but it has simplified rules for recursion and for upgrading and downgrading lock state. avoids many cases of potential deadlock. In addition, the performance of is significantly better than . is recommended for all new development. -> - is not thread-abort safe. You should not use it in an environment where threads accessing it can be aborted, such as .NET Framework. If you're using .NET Core or .NET 5+, it should be fine. is not supported in .NET Core and [is obsolete](/dotnet/core/compatibility/core-libraries/5.0/thread-abort-obsolete) in .NET 5 and later versions. +> is similar to , but it has simplified rules for recursion and for upgrading and downgrading lock state. avoids many cases of potential deadlock. In addition, the performance of is significantly better than . is recommended for all new development. By default, new instances of are created with the flag and do not allow recursion. This default policy is recommended for all new development, because recursion introduces unnecessary complications and makes your code more prone to deadlocks. To simplify migration from existing projects that use or , you can use the flag to create instances of that allow recursion. diff --git a/xml/System/Char.xml b/xml/System/Char.xml index 663b53c834c..83b14976d58 100644 --- a/xml/System/Char.xml +++ b/xml/System/Char.xml @@ -245,7 +245,7 @@ The structure represents Unicode code points by using UTF-16 If you aren't familiar with Unicode, scalar values, code points, surrogate pairs, UTF-16, and the type, see [Introduction to character encoding in .NET](/dotnet/standard/base-types/character-encoding-introduction). -This article examines the relationship between a object and a character and discuss some common tasks performed with instances. We recommend that you consider the type, introduced in .NET Core 3.0, as an alternative to for performing some of these tasks. +This article examines the relationship between a object and a character and discusses some common tasks performed with instances. We recommend that you consider the type as an alternative to for performing some of these tasks. ## Char objects, Unicode characters, and strings diff --git a/xml/System/Environment.xml b/xml/System/Environment.xml index 9a5ddfd8fbd..85f1e262eab 100644 --- a/xml/System/Environment.xml +++ b/xml/System/Environment.xml @@ -775,7 +775,7 @@ Calling the `Environment.FailFast` method to terminate execution of an applicati ## Remarks The first element in the array contains the file name of the executing program. If the file name is not available, the first element is equal to . The remaining elements contain any additional tokens entered on the command line. -In .NET 5 and later versions, for single-file publishing, the first element is the name of the host executable. +For single-file publishing, the first element is the name of the host executable. The program file name can, but is not required to, include path information. @@ -1819,7 +1819,7 @@ By using this property, you can determine whether to access static variables in returns an OS version that may be incorrect when an application runs under Windows compatibility mode. For more information, see [GetVersionExA function remarks](/windows/win32/api/sysinfoapi/nf-sysinfoapi-getversionexa#remarks). -In .NET 5 and later versions, returns the actual OS version in compatibility modes specified by the [application manifest](/windows/win32/sysinfo/targeting-your-application-at-windows-8-1). For more information, see [Environment.OSVersion returns the correct operating system version](/dotnet/core/compatibility/core-libraries/5.0/environment-osversion-returns-correct-version). + returns the actual OS version in compatibility modes specified by the [application manifest](/windows/win32/sysinfo/targeting-your-application-at-windows-8-1). For more information, see [Environment.OSVersion returns the correct operating system version](/dotnet/core/compatibility/core-libraries/5.0/environment-osversion-returns-correct-version). To identify the operating system platform, for example, Linux or Windows, you can use the method. @@ -1913,7 +1913,7 @@ To identify the operating system platform, for example, Linux or Windows, you ca Specifies whether the allocated array must be pinned. Allocates an array. An array object. - - - + To be added. @@ -285,8 +277,6 @@ In .NET 7 and earlier versions: If pinned is set to `true`, `T` must not be a re ## Remarks -In .NET 7 and earlier versions: If pinned is set to `true`, `T` must not be a reference type or a type that contains object references. - Skipping zero-initialization is a security risk. The uninitialized array can contain invalid valuetype instances or sensitive information created by other parts of the application. The code operating on uninitialized arrays should be heavily scrutinized to ensure that the uninitialized data is never read. diff --git a/xml/System/Guid.xml b/xml/System/Guid.xml index c3c90535332..b2897420e40 100644 --- a/xml/System/Guid.xml +++ b/xml/System/Guid.xml @@ -1119,7 +1119,7 @@ On Windows, this function wraps a call to the [CoCreateGuid](/windows/win32/api/combaseapi/nf-combaseapi-cocreateguid) function. The generated GUID contains 122 bits of strong entropy. - On non-Windows platforms, starting with .NET 6, this function calls the OS's underlying cryptographically secure pseudo-random number generator (CSPRNG) to generate 122 bits of strong entropy. In previous versions of .NET, the entropy is not guaranteed to be generated by a CSPRNG. + On non-Windows platforms, this function calls the OS's underlying cryptographically secure pseudo-random number generator (CSPRNG) to generate 122 bits of strong entropy. It is recommended that applications __not__ use the _NewGuid_ method for cryptographic purposes. First, since a Version 4 UUID has a partially predictable bit pattern, the _NewGuid_ function cannot serve as a proper cryptographic pseudo-random function (PRF). If the output of _NewGuid_ is given to a cryptographic component that requires its input to be generated by a proper PRF, the cryptographic component may not be able to maintain its security properties. Second, _NewGuid_ utilizes at most 122 bits of entropy, regardless of platform. Some cryptographic components set a minimum entropy level on their inputs as a matter of policy. Such policies often set the minimum entropy level at 128 bits or higher. Passing the output of _NewGuid_ to such a routine may violate its policy. diff --git a/xml/System/IAsyncDisposable.xml b/xml/System/IAsyncDisposable.xml index 63d5c3e59f9..f750799eaa5 100644 --- a/xml/System/IAsyncDisposable.xml +++ b/xml/System/IAsyncDisposable.xml @@ -62,7 +62,7 @@ If your application uses an object that implements `IAsyncDisposable`, you shoul You might implement `IAsyncDisposable` in the following situations: -- When developing an asynchronous enumerator that owns unmanaged resources. Asynchronous enumerators are used with the C# 8.0 async streams feature. For more information about async streams, see [Tutorial: Generate and consume async streams using C# 8.0 and .NET Core 3.0](/dotnet/csharp/tutorials/generate-consume-asynchronous-stream). +- When developing an asynchronous enumerator that owns unmanaged resources. Asynchronous enumerators are used with the C# 8.0 async streams feature. For more information about async streams, see [Tutorial: Generate and consume async streams](/dotnet/csharp/tutorials/generate-consume-asynchronous-stream). - When your class owns unmanaged resources and releasing them requires a resource-intensive I/O operation, such as flushing the contents of an intermediate buffer into a file or sending a packet over a network to close a connection. Use the method to perform whatever cleanup is necessary after using the unmanaged resources, such as freeing, releasing, or resetting the unmanaged resources. For more information, see [Implement a DisposeAsync method](/dotnet/standard/garbage-collection/implementing-disposeasync). diff --git a/xml/System/IntPtr.xml b/xml/System/IntPtr.xml index bf8aa908bd5..fadd7147f16 100644 --- a/xml/System/IntPtr.xml +++ b/xml/System/IntPtr.xml @@ -262,11 +262,11 @@ > [!NOTE] > Using as a pointer or a handle is error prone and unsafe. It is simply an integer type that can be used as an interchange format for pointers and handles due to being the same size. Outside of specific interchange requirements, such as for passing data to a language that doesn't support pointers, a correctly typed pointer should be used to represent pointers and should be used to represent handles. - This type implements the and interfaces. In .NET 7 and later versions, this type also implements the , , and interfaces. + This type implements the , , , , and interfaces. In C# starting from version 9.0, you can use the built-in `nint` type to define native-sized integers. This type is represented by the type internally and provides operations and conversions that are appropriate for integer types. For more information, see [nint and nuint types](/dotnet/csharp/language-reference/builtin-types/integral-numeric-types). - In C# starting from version 11 and when targeting the .NET 7 or later runtime, `nint` is an alias for in the same way that `int` is an alias for . + In C# starting from version 11, `nint` is an alias for in the same way that `int` is an alias for . ## Examples @@ -1740,7 +1740,7 @@ For this method matches the IEEE The addition operation does not throw an exception if the result is too large to represent as a signed integer in the executing process. Instead, it is performed in an unchecked context. - In C# starting from version 11 and when targeting the .NET 7 or later runtime, this API is only accessible via reflection. The addition operator is directly recognized by the language and will follow the normal language behavior for addition operations, including overflowing in a `checked` context if the result is too large to represent. + In C# starting from version 11, this API is only accessible via reflection. The addition operator is directly recognized by the language and will follow the normal language behavior for addition operations, including overflowing in a `checked` context if the result is too large to represent. The equivalent method for this operator is ]]> @@ -2236,7 +2236,7 @@ For this method matches the IEEE The subtraction operation does not throw an exception if the result is too small to represent as a signed integer in the executing process. Instead, it is performed in an unchecked context. - In C# starting from version 11 and when targeting the .NET 7 or later runtime, this API is only accessible via reflection. The subtraction operator is directly recognized by the language and will follow the normal language behavior for subtraction operations, including overflowing in a `checked` context if the result is too small to represent. + In C# starting from version 11, this API is only accessible via reflection. The subtraction operator is directly recognized by the language and will follow the normal language behavior for subtraction operations, including overflowing in a `checked` context if the result is too small to represent. The equivalent method for this operator is ]]> diff --git a/xml/System/MarshalByRefObject.xml b/xml/System/MarshalByRefObject.xml index afc23c057d4..d22c72ece83 100644 --- a/xml/System/MarshalByRefObject.xml +++ b/xml/System/MarshalByRefObject.xml @@ -158,7 +158,7 @@ ## Remarks -This method is marked obsolete starting in .NET 5. +This method is obsolete. ]]> @@ -216,7 +216,7 @@ This method is marked obsolete starting in .NET 5. ## Remarks -This method is marked obsolete starting in .NET 5. +This method is obsolete. ]]> diff --git a/xml/System/String.xml b/xml/System/String.xml index 3106c6e8e14..eb3ed75ca94 100644 --- a/xml/System/String.xml +++ b/xml/System/String.xml @@ -167,14 +167,6 @@ Each character in a string has an associated Unicode character category, which i .NET maintains its own table of characters and their corresponding categories, which ensures that a specific version of a .NET implementation running on different platforms returns identical character category information. On all .NET versions and across all OS platforms, character category information is provided by the [Unicode Character Database](https://www.unicode.org/ucd/). -The following table lists .NET versions and the versions of the Unicode Standard on which their character categories are based. - -| .NET version | Version of the Unicode Standard | -|---------------|-----------------------------------------------------------------------------------------| -| .NET Core 2.1 | [The Unicode Standard, Version 8.0.0](https://www.unicode.org/versions/Unicode8.0.0/) | -| .NET Core 3.1 | [The Unicode Standard, Version 11.0.0](https://www.unicode.org/versions/Unicode11.0.0/) | -| .NET 5 | [The Unicode Standard, Version 13.0.0](https://www.unicode.org/versions/Unicode13.0.0/) | - In addition, .NET supports string comparison and sorting based on the Unicode standard. String comparison and sorting information is provided by [International Components for Unicode](https://icu.unicode.org/) libraries (except on Windows versions prior to Windows 10 May 2019 Update). ## Embedded null characters @@ -5572,7 +5564,7 @@ If you are new to the `String.Format` method, see method or by calling to deserialize a object that represents the required time zone. However, time zones created by these method calls are not system-defined time and cannot be retrieved using the method. These custom time zones can be accessed only through the object reference returned by the or method call. -In .NET 7 and earlier versions, this method returns a new instance for each method call. This might impact performance in applications that call the `FindSystemTimeZoneById` method repeatedly with the same identifier. (In .NET 8 and later versions, this method always returns a cached instance.) +This method always returns a cached instance. ## Examples @@ -3474,7 +3474,7 @@ The time zone identifier is a key string that uniquely identifies a particular t ## Remarks -This API is exclusively supported on .NET 6 and later versions, and only when the application utilizes the ICU library. +This API is supported only when the application utilizes the ICU library. However, in .NET, the ICU library is not always used by default, particularly in the following scenarios: - When the application runs on an operating system that does not have the ICU library, and the app does not utilize the [app-local ICU](/dotnet/core/extensions/globalization-icu#app-local-icu) feature. @@ -3540,7 +3540,7 @@ If the application is running on a Windows OS version that lacks the ICU library ## Remarks -This API is exclusively supported on .NET 6.0 and later versions. It is also supported when the application utilizes the ICU library, otherwise the API will fail. +This API is supported only when the application utilizes the ICU library; otherwise, the API fails. However, in .NET, the ICU library is not always used by default, particularly in the following scenarios: - When the application runs on an operating system that does not have the ICU library, and the app does not utilize the [APP-Local ICU](/dotnet/core/extensions/globalization-icu#app-local-icu) feature. @@ -3606,7 +3606,7 @@ If the application is running on a Windows OS version that lacks the ICU library ## Remarks -This API is exclusively supported on .NET 6.0 and later versions. It is also supported when the application utilizes the ICU library, otherwise the API will fail. +This API is supported only when the application utilizes the ICU library; otherwise, the API fails. However, in .NET, the ICU library is not always used by default, particularly in the following scenarios: - When the application runs on an operating system that does not have the ICU library, and the app does not utilize the [App-local ICU](/dotnet/core/extensions/globalization-icu#app-local-icu) feature. diff --git a/xml/System/Type.xml b/xml/System/Type.xml index f746887b89e..65cbde8f8c4 100644 --- a/xml/System/Type.xml +++ b/xml/System/Type.xml @@ -2622,7 +2622,7 @@ False method does not return constructors in a particular order, such as declaration order. Your code must not depend on the order in which constructors are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns constructors in a deterministic order based upon the metadata ordering in the assembly. The following table shows what members of a base class are returned by the `Get` methods when reflecting on a type. @@ -2721,7 +2721,7 @@ The following filter flags can be used to See for more information. -In .NET 6 and earlier versions, the method does not return constructors in a particular order, such as declaration order. Your code must not depend on the order in which constructors are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. +The method returns constructors in a deterministic order based upon the metadata ordering in the assembly. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. For example, if class `C` has a constructor `C(T t1)` (`Sub New(ByVal t1 As T)` in Visual Basic), calling on `C` returns a that represents `C(int t1)` in C# (`Sub New(ByVal t1 As Integer)` in Visual Basic). @@ -3421,7 +3421,7 @@ If the current represents a generic type parameter, the | | (in Visual Basic, combine the values using ` Or `) to get it. - In .NET 6 and earlier versions, the method does not return events in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which events are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns events in a deterministic order based upon the metadata ordering in the assembly. This method can be overridden by a derived class. @@ -3524,7 +3524,7 @@ If the current represents a generic type parameter, the method does not return events in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which events are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns events in a deterministic order based upon the metadata ordering in the assembly. The following filter flags can be used to define which events to include in the search: @@ -3845,7 +3845,7 @@ If the current represents a generic type parameter, the method does not return fields in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which fields are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns fields in a deterministic order based upon the metadata ordering in the assembly. The following table shows what members of a base class are returned by the `Get` methods when reflecting on a type. @@ -3970,7 +3970,7 @@ The following modifier flags can be used t See for more information. -In .NET 6 and earlier versions, the method does not return fields in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which fields are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. +The method returns fields in a deterministic order based upon the metadata ordering in the assembly. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. @@ -4713,7 +4713,7 @@ The current instance or argument is an open ge method does not return interfaces in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which interfaces are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns interfaces in a deterministic order based upon the metadata ordering in the assembly. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. @@ -4799,7 +4799,7 @@ The current instance or argument is an open ge Members include properties, methods, fields, events, and so on. - In .NET 6 and earlier versions, the method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns members in a deterministic order based upon the metadata ordering in the assembly. This method overload will not find class initializers (static constructor). To find class initializers, use an overload that takes , and specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. @@ -4918,7 +4918,7 @@ The current instance or argument is an open ge Members include properties, methods, fields, events, and so on. - In .NET 6 and earlier versions, the method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns members in a deterministic order based upon the metadata ordering in the assembly. The following filter flags can be used to define which members to include in the search: @@ -5036,7 +5036,7 @@ The current instance or argument is an open ge ## Remarks Members include properties, methods, fields, events, and so on. - In .NET 6 and earlier versions, the method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns members in a deterministic order based upon the metadata ordering in the assembly. The following filter flags can be used to define which members to include in the search: @@ -5154,7 +5154,7 @@ The current instance or argument is an open ge Members include properties, methods, constructors, fields, events, and nested types. - In .NET 6 and earlier versions, the method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns members in a deterministic order based upon the metadata ordering in the assembly. This method overload calls the method overload, with | | (` Or `` Or ` in Visual Basic). It will not find class initializers (static constructors). To find class initializers, call the overload, and specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. @@ -5287,7 +5287,7 @@ The following modifier flags can be used t See for more information. -In .NET 6 and earlier versions, the method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. +The method returns members in a deterministic order based upon the metadata ordering in the assembly. To get the class initializer (static constructor) using this method overload, you must specify | (` Or ` in Visual Basic). You can also get the class initializer using the property. @@ -6917,7 +6917,7 @@ An empty array of the type (that is, Type[] types = ## Remarks -In .NET 6 and earlier versions, the method does not return methods in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which methods are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. +The method returns methods in a deterministic order based upon the metadata ordering in the assembly. Constructors are not included in the array of methods returned by this call. Make a separate call to `GetConstructors()` to get the constructor methods. @@ -7038,7 +7038,7 @@ For the `GetMethods(BindingFlags)` overload to successfully retrieve method info See for more information. -In .NET 6 and earlier versions, the method does not return methods in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which methods are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. +The method returns methods in a deterministic order based upon the metadata ordering in the assembly. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. @@ -7320,7 +7320,7 @@ If the current represents a type parameter in the definition method does not return types in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which types are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns types in a deterministic order based upon the metadata ordering in the assembly. Only the public types immediately nested in the current type are returned; the search is not recursive. @@ -7422,7 +7422,7 @@ If the current represents a type parameter in the definition ## Remarks The search for nested types is not recursive. - In .NET 6 and earlier versions, the method does not return types in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which types are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns types in a deterministic order based upon the metadata ordering in the assembly. The following filter flags can be used to define which nested types to include in the search: @@ -7595,7 +7595,7 @@ If the current represents a type parameter in the definition A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use | | (in Visual Basic, combine the values using ` Or `) to get it. - In .NET 6 and earlier versions, the method does not return properties in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which properties are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. + The method returns properties in a deterministic order based upon the metadata ordering in the assembly. The following table shows what members of a base class are returned by the `Get` methods when reflecting on a type. @@ -7720,7 +7720,7 @@ The following filter flags can be used to See for more information. -In .NET 6 and earlier versions, the method does not return properties in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which properties are returned, because that order varies. However, starting with .NET 7, the ordering is deterministic based upon the metadata ordering in the assembly. +The method returns properties in a deterministic order based upon the metadata ordering in the assembly. If the current represents a constructed generic type, this method returns the objects with the type parameters replaced by the appropriate type arguments. diff --git a/xml/System/UIntPtr.xml b/xml/System/UIntPtr.xml index 5355ff23c81..e034f9f4037 100644 --- a/xml/System/UIntPtr.xml +++ b/xml/System/UIntPtr.xml @@ -264,11 +264,11 @@ > [!NOTE] > Using as a pointer or a handle is error prone and unsafe. It is simply an integer type that can be used as an interchange format for pointers and handles due to being the same size. Outside of specific interchange requirements, such as for passing data to a language that doesn't support pointers, a correctly typed pointer should be used to represent pointers and should be used to represent handles. - This type implements the and interfaces. In .NET 7 and later versions, this type also implements the , , and interfaces. + This type implements the and interfaces. This type also implements the , , and interfaces. In C# starting from version 9.0, you can use the built-in `nuint` type to define native-sized integers. This type is represented by the type internally and provides operations and conversions that are appropriate for integer types. For more information, see [nint and nuint types](/dotnet/csharp/language-reference/builtin-types/integral-numeric-types). - In C# starting from version 11 and when targeting the .NET 7 or later runtime, `nuint` is an alias for in the same way that `uint` is an alias for . + In C# starting from version 11, `nuint` is an alias for in the same way that `uint` is an alias for . ]]> @@ -1455,7 +1455,7 @@ For this method matches the IEEE 754:201 The addition operation does not throw an exception if the result is too large to represent as an unsigned integer in the executing process. Instead, it is performed in an unchecked context. - In C# starting from version 11 and when targeting the .NET 7 or later runtime, this API is only accessible via reflection. The addition operator is directly recognized by the language and will follow the normal language behavior for addition operations, including overflowing in a `checked` context if the result is too large to represent. + In C# starting from version 11, this API is only accessible via reflection. The addition operator is directly recognized by the language and will follow the normal language behavior for addition operations, including overflowing in a `checked` context if the result is too large to represent. The equivalent method for this operator is . ]]> @@ -1955,7 +1955,7 @@ For this method matches the IEEE 754:201 The subtraction operation does not throw an exception if the result is too small to represent as an unsigned integer in the executing process. Instead, it is performed in an unchecked context. - In C# starting from version 11 and when targeting the .NET 7 or later runtime, this API is only accessible via reflection. The subtraction operator is directly recognized by the language and will follow the normal language behavior for subtraction operations, including overflowing in a `checked` context if the result is too small to represent. + In C# starting from version 11, this API is only accessible via reflection. The subtraction operator is directly recognized by the language and will follow the normal language behavior for subtraction operations, including overflowing in a `checked` context if the result is too small to represent. ]]> diff --git a/xml/System/Uri.xml b/xml/System/Uri.xml index 8b3b3a39c84..c0acb466e0e 100644 --- a/xml/System/Uri.xml +++ b/xml/System/Uri.xml @@ -163,7 +163,7 @@ Uri uri1 = new Uri("C:/test/path/file.txt") // Implicit file path. Uri uri2 = new Uri("file:///C:/test/path/file.txt") // Explicit file path. ``` -These implicit file paths are not compliant with the URI specification and should be avoided when possible. When using .NET Core on Unix-based systems, implicit file paths can be especially problematic, because an absolute implicit file path is *indistinguishable* from a relative path. When such ambiguity is present, default to interpreting the path as an absolute URI. +These implicit file paths are not compliant with the URI specification and should be avoided when possible. When using .NET on Unix-based systems, implicit file paths can be especially problematic, because an absolute implicit file path is *indistinguishable* from a relative path. When such ambiguity is present, defaults to interpreting the path as an absolute URI. ## Security considerations 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.