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.