Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions xml/System.Reflection/Assembly.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1656,7 +1656,7 @@ Many members of the <xref:System.Reflection.Assembly> 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.

]]></format>
</remarks>
Expand Down Expand Up @@ -3329,7 +3329,7 @@ If there are assembly-qualified generic type parameters in the type name string,
<summary>Gets a value indicating whether the assembly was loaded from the global assembly cache (.NET Framework only).</summary>
<value>
<see langword="false" /> in all cases.</value>
<remarks>This property is marked obsolete starting in .NET 5, and generates a compile-time warning.</remarks>
<remarks>This property is marked obsolete and generates a compile-time warning.</remarks>
</Docs>
</Member>
<Member MemberName="HostContext">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 <xref:System.Runtime.InteropServices.Marshal.GetLastPInvokeError*>. On earlier .NET versions, call <xref:System.Runtime.InteropServices.Marshal.GetLastWin32Error*>.
You can retrieve the error code by calling <xref:System.Runtime.InteropServices.Marshal.GetLastPInvokeError*>.

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 <xref:System.Runtime.InteropServices.Marshal.GetLastPInvokeError*> and <xref:System.Runtime.InteropServices.Marshal.GetLastWin32Error*> represents only the error information from the last p/invoke with <xref:System.Runtime.InteropServices.DllImportAttribute.SetLastError?displayProperty=nameWithType> set to `true`.

Expand Down
10 changes: 5 additions & 5 deletions xml/System.Runtime.InteropServices/Marshal.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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 <xref:System.Runtime.InteropServices.NativeMemory> 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 <xref:System.Runtime.InteropServices.NativeMemory> class on all platforms to allocate native memory.

<xref:System.Runtime.InteropServices.Marshal.AllocHGlobal*> is one of two memory allocation methods in the <xref:System.Runtime.InteropServices.Marshal> class. (<xref:System.Runtime.InteropServices.Marshal.AllocCoTaskMem*?displayProperty=nameWithType> is the other.) This method exposes the Win32 [LocalAlloc](https://learn.microsoft.com/windows/win32/api/winbase/nf-winbase-localalloc) function from Kernel32.dll.

Expand Down Expand Up @@ -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 <xref:System.Runtime.InteropServices.NativeMemory> 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 <xref:System.Runtime.InteropServices.NativeMemory> class on all platforms to allocate native memory.

<xref:System.Runtime.InteropServices.Marshal.AllocHGlobal*> is one of two memory allocation methods in the <xref:System.Runtime.InteropServices.Marshal> class. (<xref:System.Runtime.InteropServices.Marshal.AllocCoTaskMem*?displayProperty=nameWithType> is the other.) This method exposes the Win32 [LocalAlloc](https://learn.microsoft.com/windows/win32/api/winbase/nf-winbase-localalloc) function from Kernel32.dll.

Expand Down Expand Up @@ -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 <xref:System.Runtime.InteropServices.NativeMemory> 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 <xref:System.Runtime.InteropServices.NativeMemory> class on all platforms to allocate native memory.

You can use <xref:System.Runtime.InteropServices.Marshal.FreeHGlobal*> to free any memory from the global heap allocated by <xref:System.Runtime.InteropServices.Marshal.AllocHGlobal*>, <xref:System.Runtime.InteropServices.Marshal.ReAllocHGlobal*>, or any equivalent unmanaged API method. If the `hglobal` parameter is <xref:System.IntPtr.Zero?displayProperty=nameWithType> the method does nothing.

Expand Down Expand Up @@ -4314,7 +4314,7 @@ You can use this method to obtain error codes only if you apply the <xref:System

Error information is cleared before P/Invoke call, and the `GetLastWin32Error` represents only error information from the last method call.

This method is functionally equivalent to <xref:System.Runtime.InteropServices.Marshal.GetLastPInvokeError*>, which is named to better reflect the intent of the API and its cross-platform nature. On .NET 6 and later versions, prefer <xref:System.Runtime.InteropServices.Marshal.GetLastPInvokeError*> over <xref:System.Runtime.InteropServices.Marshal.GetLastWin32Error*>.
This method is functionally equivalent to <xref:System.Runtime.InteropServices.Marshal.GetLastPInvokeError*>, which is named to better reflect the intent of the API and its cross-platform nature. Prefer <xref:System.Runtime.InteropServices.Marshal.GetLastPInvokeError*> over <xref:System.Runtime.InteropServices.Marshal.GetLastWin32Error*>.

## 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.
Expand Down Expand Up @@ -8052,7 +8052,7 @@ This method is functionally equivalent to <xref:System.Runtime.InteropServices.M

## 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. For .NET 6 and later, use the <xref:System.Runtime.InteropServices.NativeMemory> class instead to allocate native memory. On earlier targets where <xref:System.Runtime.InteropServices.NativeMemory> is unavailable, continue to use the appropriate <xref:System.Runtime.InteropServices.Marshal> 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 <xref:System.Runtime.InteropServices.NativeMemory> class instead to allocate native memory.

<xref:System.Runtime.InteropServices.Marshal.ReAllocHGlobal*> is one of two memory reallocation API methods in the <xref:System.Runtime.InteropServices.Marshal> class. (<xref:System.Runtime.InteropServices.Marshal.ReAllocCoTaskMem*?displayProperty=nameWithType> is the other.)

Expand Down
2 changes: 1 addition & 1 deletion xml/System.Runtime.InteropServices/NativeLibrary.xml
Original file line number Diff line number Diff line change
Expand Up @@ -216,7 +216,7 @@ Calling this method with an invalid `handle` parameter other than <xref:System.I
<format type="text/markdown"><![CDATA[
Given a library name, this method searches specific paths based on the runtime configuration, input parameters, and attributes of the calling assembly. If the `searchPath` parameter is non-null, the flags in this enumeration are used. Otherwise, the flags specified by the <xref:System.Runtime.InteropServices.DefaultDllImportSearchPathsAttribute> on the calling assembly, if any are present, are used. This method does not invoke the resolver registered using <xref:System.Runtime.InteropServices.NativeLibrary.SetDllImportResolver(System.Reflection.Assembly,System.Runtime.InteropServices.DllImportResolver)>
method. Starting with .NET 5, this method does invoke the <xref:System.Runtime.Loader.AssemblyLoadContext.LoadUnmanagedDll*?displayProperty=nameWithType> method and the <xref:System.Runtime.Loader.AssemblyLoadContext.ResolvingUnmanagedDll?displayProperty=nameWithType> event.
method. This method invokes the <xref:System.Runtime.Loader.AssemblyLoadContext.LoadUnmanagedDll*?displayProperty=nameWithType> method and the <xref:System.Runtime.Loader.AssemblyLoadContext.ResolvingUnmanagedDll?displayProperty=nameWithType> event.
]]></format>
</remarks>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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).

]]></format>
</remarks>
Expand Down
1 change: 0 additions & 1 deletion xml/System.Runtime.Loader/AssemblyLoadContext.xml
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,6 @@ The <xref:System.Runtime.Loader.AssemblyLoadContext> exists primarily to provide
> [!NOTE]
>
> * <xref:System.Runtime.Loader.AssemblyLoadContext> does not provide any security features. All code has full permissions of the process.
> * In .NET Core 2.0 - 2.2 only, <xref:System.Runtime.Loader.AssemblyLoadContext> is an abstract class. To create a concrete class in these versions, implement the <xref:System.Runtime.Loader.AssemblyLoadContext.Load(System.Reflection.AssemblyName)?displayProperty=nameWithType> method.
## Usage in the runtime
Expand Down
4 changes: 2 additions & 2 deletions xml/System.Security.Authentication/SslProtocols.xml
Original file line number Diff line number Diff line change
Expand Up @@ -310,7 +310,7 @@
</ReturnValue>
<MemberValue>192</MemberValue>
<Docs>
<summary>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.</summary>
<summary>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.</summary>
</Docs>
</Member>
<Member MemberName="Tls11">
Expand Down Expand Up @@ -356,7 +356,7 @@
</ReturnValue>
<MemberValue>768</MemberValue>
<Docs>
<summary>Specifies the TLS 1.1 security protocol. The TLS protocol is defined in IETF RFC 4346. This member is obsolete starting in .NET 7.</summary>
<summary>Specifies the TLS 1.1 security protocol. The TLS protocol is defined in IETF RFC 4346. This member is obsolete.</summary>
</Docs>
</Member>
<Member MemberName="Tls12">
Expand Down
4 changes: 2 additions & 2 deletions xml/System.Security.Cryptography/AesCng.xml
Original file line number Diff line number Diff line change
Expand Up @@ -390,7 +390,7 @@ This method decrypts an encrypted message created using the <xref:System.Securit

]]></format>
</remarks>
<exception cref="T:System.Security.Cryptography.CryptographicException">.NET 6 and later: CFB128 mode is selected and the key is persisted.</exception>
<exception cref="T:System.Security.Cryptography.CryptographicException">CFB128 mode is selected and the key is persisted.</exception>
</Docs>
</Member>
<Member MemberName="CreateDecryptor">
Expand Down Expand Up @@ -529,7 +529,7 @@ Use this method to encrypt a message and then use the <xref:System.Security.Cryp

]]></format>
</remarks>
<exception cref="T:System.Security.Cryptography.CryptographicException">.NET 6 and later: CFB128 mode is selected and the key is persisted.</exception>
<exception cref="T:System.Security.Cryptography.CryptographicException">CFB128 mode is selected and the key is persisted.</exception>
</Docs>
</Member>
<Member MemberName="CreateEncryptor">
Expand Down
6 changes: 3 additions & 3 deletions xml/System.Security.Cryptography/CryptoStream.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1343,7 +1343,7 @@ This property exists only to support inheritance from <xref:System.IO.Stream>, a
<param name="count">The maximum number of bytes to be read from the current stream.</param>
<summary>Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.</summary>
<returns>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.</returns>
<remarks>Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see <see href="/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams">Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream</see>.</remarks>
<remarks>This method might not read as many bytes as were requested. For more information, see <see href="/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams">Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream</see>.</remarks>
<exception cref="T:System.NotSupportedException">The <see cref="T:System.Security.Cryptography.CryptoStreamMode" /> associated with current <see cref="T:System.Security.Cryptography.CryptoStream" /> object does not match the underlying stream. For example, this exception is thrown when using <see cref="F:System.Security.Cryptography.CryptoStreamMode.Read" /> with an underlying stream that is write only.</exception>
<exception cref="T:System.ArgumentOutOfRangeException">
<paramref name="offset" /> or <paramref name="count" /> is less than zero.</exception>
Expand Down Expand Up @@ -1390,7 +1390,7 @@ This property exists only to support inheritance from <xref:System.IO.Stream>, a
<param name="cancellationToken">The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
<summary>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.</summary>
<returns>A task that represents the asynchronous read operation. The value of its <see cref="P:System.Threading.Tasks.ValueTask`1.Result" /> 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.</returns>
<remarks>Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see <see href="/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams">Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream</see>.</remarks>
<remarks>This method might not read as many bytes as were requested. For more information, see <see href="/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams">Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream</see>.</remarks>
<exception cref="T:System.NotSupportedException">The <see cref="T:System.Security.Cryptography.CryptoStreamMode" /> associated with the current <see cref="T:System.Security.Cryptography.CryptoStream" /> object does not match the underlying stream. For example, this exception is thrown when using <see cref="F:System.Security.Cryptography.CryptoStreamMode.Read" /> with an underlying stream that's write only.</exception>
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
<inheritdoc />
Expand Down Expand Up @@ -1451,7 +1451,7 @@ This property exists only to support inheritance from <xref:System.IO.Stream>, a
<format type="text/markdown"><![CDATA[

> [!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 <xref:System.Security.Cryptography.CryptoStream.ReadAsync*> 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/).

Expand Down
3 changes: 1 addition & 2 deletions xml/System.Security.Cryptography/FromBase64Transform.xml
Original file line number Diff line number Diff line change
Expand Up @@ -284,8 +284,7 @@
<summary>Gets a value that indicates whether multiple blocks can be transformed.</summary>
<value>A value that indicates whether multiple blocks can be transformed.</value>
<remarks>
<para>Prior to .NET 5, only one block can be transformed at a time, so this property returns <see langword="false" />.</para>
<para>Starting in .NET 5, multiple blocks can be transformed, so this property returns <see langword="true" />.</para>
<para>Multiple blocks can be transformed, so this property returns <see langword="true" />.</para>
</remarks>
<related type="Article" href="/dotnet/standard/security/cryptographic-services">Cryptographic Services</related>
</Docs>
Expand Down
Loading
Loading