AesGcm Constructores

Definición

Espacio de nombres:

System.Security.Cryptography

Ensamblado:

System.Security.Cryptography.dll

Sobrecargas

AesGcm(Byte[])	Obsoletos. Inicializa una nueva instancia de la clase AesGcm con la clave proporcionada.
AesGcm(ReadOnlySpan<Byte>)	Obsoletos. Inicializa una nueva instancia de la clase AesGcm con la clave proporcionada.
AesGcm(Byte[], Int32)	Inicializa una nueva instancia de la AesGcm clase con una clave proporcionada y el tamaño de etiqueta necesario.
AesGcm(ReadOnlySpan<Byte>, Int32)	Inicializa una nueva instancia de la AesGcm clase con una clave proporcionada y el tamaño de etiqueta necesario.

AesGcm(Byte[])

Source:

AesGcm.cs

Precaución

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

Inicializa una nueva instancia de la clase AesGcm con la clave proporcionada.

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

Parámetros

key

Byte[]

Clave secreta que se va a usar para esta instancia.

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

El parámetro key es null.

CryptographicException

La longitud del parámetro key es distinta de 16, 24 o 32 bytes (128, 192 o 256 bits).

AesGcm(ReadOnlySpan<Byte>)

Source:

AesGcm.cs

Precaución

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

Inicializa una nueva instancia de la clase AesGcm con la clave proporcionada.

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

Parámetros

key

ReadOnlySpan<Byte>

Clave secreta que se va a usar para esta instancia.

Atributos

ObsoleteAttribute

Excepciones

CryptographicException

La longitud del parámetro key es distinta de 16, 24 o 32 bytes (128, 192 o 256 bits).

AesGcm(Byte[], Int32)

Source:

AesGcm.cs

Inicializa una nueva instancia de la AesGcm clase con una clave proporcionada y el tamaño de etiqueta necesario.

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)

Parámetros

key

Byte[]

Clave secreta que se va a usar para esta instancia.

tagSizeInBytes

Int32

Tamaño de la etiqueta, en bytes, que el cifrado y el descifrado deben usar.

Excepciones

ArgumentNullException

El parámetro key es null.

CryptographicException

La longitud del parámetro key es distinta de 16, 24 o 32 bytes (128, 192 o 256 bits).

ArgumentException

El tagSizeInBytes parámetro es un tamaño de etiqueta no admitido indicado por TagByteSizes.

PlatformNotSupportedException

La plataforma actual no admite AES-GCM.

Comentarios

El tagSizeInBytes parámetro se usa para indicar que el parámetro de etiqueta en Encrypt o Decrypt debe ser exactamente este tamaño. Si se indica el tamaño de etiqueta necesario, se evitan problemas en los que los autores de llamadas de Decrypt pueden proporcionar una etiqueta como entrada y esa entrada se trunca a un tamaño inesperado.

AesGcm(ReadOnlySpan<Byte>, Int32)

Source:

AesGcm.cs

Inicializa una nueva instancia de la AesGcm clase con una clave proporcionada y el tamaño de etiqueta necesario.

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)

Parámetros

key

ReadOnlySpan<Byte>

Clave secreta que se va a usar para esta instancia.

tagSizeInBytes

Int32

Tamaño de la etiqueta, en bytes, que el cifrado y el descifrado deben usar.

Excepciones

CryptographicException

La longitud del parámetro key es distinta de 16, 24 o 32 bytes (128, 192 o 256 bits).

ArgumentException

El tagSizeInBytes parámetro es un tamaño de etiqueta no admitido indicado por TagByteSizes.

PlatformNotSupportedException

La plataforma actual no admite AES-GCM.

Comentarios

El tagSizeInBytes parámetro se usa para indicar que el parámetro de etiqueta en Encrypt o Decrypt debe ser exactamente este tamaño. Si se indica el tamaño de etiqueta necesario, se evitan problemas en los que los autores de llamadas de Decrypt pueden proporcionar una etiqueta como entrada y esa entrada se trunca a un tamaño inesperado.