AesGcm Конструкторы

Определение

Пространство имен:

System.Security.Cryptography

Сборки:

netstandard.dll, System.Security.Cryptography.dll

Инициализирует новый экземпляр класса AesGcm.

Перегрузки

Имя	Описание
AesGcm(Byte[])	Устаревшие. Инициализирует новый экземпляр AesGcm класса с предоставленным ключом.
AesGcm(ReadOnlySpan<Byte>)	Устаревшие. Инициализирует новый экземпляр AesGcm класса с предоставленным ключом.
AesGcm(Byte[], Int32)	Инициализирует новый экземпляр AesGcm класса с предоставленным ключом и необходимым размером тега.
AesGcm(ReadOnlySpan<Byte>, Int32)	Инициализирует новый экземпляр AesGcm класса с предоставленным ключом и необходимым размером тега.

AesGcm(Byte[])

Исходный код:

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>)

Исходный код:

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)

Исходный код:

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 используется для указания того, что параметр тега в Encrypt или Decrypt должен быть именно таким размером. Указывая, что требуемый размер тега предотвращает проблемы, когда вызывающие пользователи Decrypt могут предоставить тег в качестве входных данных, и входные данные усечены до неожиданного размера.

AesGcm(ReadOnlySpan<Byte>, Int32)

Исходный код:

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 используется для указания того, что параметр тега в Encrypt или Decrypt должен быть именно таким размером. Указывая, что требуемый размер тега предотвращает проблемы, когда вызывающие пользователи Decrypt могут предоставить тег в качестве входных данных, и входные данные усечены до неожиданного размера.