AesGcm 构造函数

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.dll

重载

AesGcm(Byte[])	已过时. 使用所提供的密钥来初始化 AesGcm 类的一个新实例。
AesGcm(ReadOnlySpan<Byte>)	已过时. 使用所提供的密钥来初始化 AesGcm 类的一个新实例。
AesGcm(Byte[], Int32)	使用提供的键和所需的标记大小初始化 类的新实例 AesGcm 。
AesGcm(ReadOnlySpan<Byte>, Int32)	使用提供的键和所需的标记大小初始化 类的新实例 AesGcm 。

AesGcm(Byte[])

Source:

AesGcm.cs

注意

AesGcm should indicate the required tag size for encryption and decryption. Use a constructor that accepts the tag size.

使用所提供的密钥来初始化 AesGcm 类的一个新实例。

public:
 AesGcm(cli::array <System::Byte> ^ key);

[System.Obsolete("AesGcm should indicate the required tag size for encryption and decryption. Use a constructor that accepts the tag size.", DiagnosticId="SYSLIB0053", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public AesGcm (byte[] key);

[<System.Obsolete("AesGcm should indicate the required tag size for encryption and decryption. Use a constructor that accepts the tag size.", DiagnosticId="SYSLIB0053", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.AesGcm : byte[] -> System.Security.Cryptography.AesGcm

Public Sub New (key As Byte())

参数

key

Byte[]

用于此实例的密钥。

属性

ObsoleteAttribute

例外

ArgumentNullException

key 参数为 null。

CryptographicException

key 参数长度不能是 16、24 或 32 字节（128、192 或 256 位）。

AesGcm(ReadOnlySpan<Byte>)

Source:

AesGcm.cs

注意

AesGcm should indicate the required tag size for encryption and decryption. Use a constructor that accepts the tag size.

使用所提供的密钥来初始化 AesGcm 类的一个新实例。

public:
 AesGcm(ReadOnlySpan<System::Byte> key);

[System.Obsolete("AesGcm should indicate the required tag size for encryption and decryption. Use a constructor that accepts the tag size.", DiagnosticId="SYSLIB0053", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public AesGcm (ReadOnlySpan<byte> key);

[<System.Obsolete("AesGcm should indicate the required tag size for encryption and decryption. Use a constructor that accepts the tag size.", DiagnosticId="SYSLIB0053", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.AesGcm : ReadOnlySpan<byte> -> System.Security.Cryptography.AesGcm

Public Sub New (key As ReadOnlySpan(Of Byte))

参数

key

ReadOnlySpan<Byte>

用于此实例的密钥。

属性

ObsoleteAttribute

例外

CryptographicException

key 参数长度不能是 16、24 或 32 字节（128、192 或 256 位）。

AesGcm(Byte[], Int32)

Source:

AesGcm.cs

使用提供的键和所需的标记大小初始化 类的新实例 AesGcm 。

public:
 AesGcm(cli::array <System::Byte> ^ key, int tagSizeInBytes);

public AesGcm (byte[] key, int tagSizeInBytes);

new System.Security.Cryptography.AesGcm : byte[] * int -> System.Security.Cryptography.AesGcm

Public Sub New (key As Byte(), tagSizeInBytes As Integer)

参数

key

Byte[]

用于此实例的密钥。

tagSizeInBytes

Int32

加密和解密必须使用的标记的大小（以字节为单位）。

例外

ArgumentNullException

key 参数为 null。

CryptographicException

key 参数长度不能是 16、24 或 32 字节（128、192 或 256 位）。

ArgumentException

参数 tagSizeInBytes 是 指示 TagByteSizes的不受支持的标记大小。

PlatformNotSupportedException

当前平台不支持 AES-GCM。

注解

参数tagSizeInBytes用于指示 或 Decrypt 中的Encrypt标记参数必须恰好是此大小。 指示所需的标记大小可防止 的调用方 Decrypt 可能提供标记作为输入，并且该输入被截断为意外大小的问题。

AesGcm(ReadOnlySpan<Byte>, Int32)

Source:

AesGcm.cs

使用提供的键和所需的标记大小初始化 类的新实例 AesGcm 。

public:
 AesGcm(ReadOnlySpan<System::Byte> key, int tagSizeInBytes);

public AesGcm (ReadOnlySpan<byte> key, int tagSizeInBytes);

new System.Security.Cryptography.AesGcm : ReadOnlySpan<byte> * int -> System.Security.Cryptography.AesGcm

Public Sub New (key As ReadOnlySpan(Of Byte), tagSizeInBytes As Integer)

参数

key

ReadOnlySpan<Byte>

用于此实例的密钥。

tagSizeInBytes

Int32

加密和解密必须使用的标记的大小（以字节为单位）。

例外

CryptographicException

key 参数长度不能是 16、24 或 32 字节（128、192 或 256 位）。

ArgumentException

参数 tagSizeInBytes 是 指示 TagByteSizes的不受支持的标记大小。

PlatformNotSupportedException

当前平台不支持 AES-GCM。

注解

参数tagSizeInBytes用于指示 或 Decrypt 中的Encrypt标记参数必须恰好是此大小。 指示所需的标记大小可防止 的调用方 Decrypt 可能提供标记作为输入，并且该输入被截断为意外大小的问题。