AesCng.CreateEncryptor Méthode

Définition

Espace de noms:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Crée un objet encrypteur symétrique AES.

Surcharges

Nom	Description
CreateEncryptor()	Crée un objet chiffreur AES symétrique à l’aide de la clé actuelle et du vecteur d’initialisation (IV).
CreateEncryptor(Byte[], Byte[])	Crée un objet chiffreur AES symétrique avec la clé et le vecteur d’initialisation spécifiés (IV).

CreateEncryptor()

Crée un objet chiffreur AES symétrique à l’aide de la clé actuelle et du vecteur d’initialisation (IV).

public:
 override System::Security::Cryptography::ICryptoTransform ^ CreateEncryptor();

public override System.Security.Cryptography.ICryptoTransform CreateEncryptor();

override this.CreateEncryptor : unit -> System.Security.Cryptography.ICryptoTransform

Public Overrides Function CreateEncryptor () As ICryptoTransform

Retours

ICryptoTransform

Objet chiffreur AES symétrique.

Exceptions

CryptographicException

.NET 6 et versions ultérieures : le mode CFB128 est sélectionné et la clé est conservée.

Remarques

Utilisez cette méthode pour chiffrer un message, puis utilisez la CreateDecryptor surcharge avec la même signature pour déchiffrer le résultat de cette méthode.

CreateEncryptor(Byte[], Byte[])

Source:

Cng.NotSupported.cs

Crée un objet chiffreur AES symétrique avec la clé et le vecteur d’initialisation spécifiés (IV).

public:
 override System::Security::Cryptography::ICryptoTransform ^ CreateEncryptor(cli::array <System::Byte> ^ rgbKey, cli::array <System::Byte> ^ rgbIV);

public override System.Security.Cryptography.ICryptoTransform CreateEncryptor(byte[] rgbKey, byte[]? rgbIV);

override this.CreateEncryptor : byte[] * byte[] -> System.Security.Cryptography.ICryptoTransform

Public Overrides Function CreateEncryptor (rgbKey As Byte(), rgbIV As Byte()) As ICryptoTransform

Paramètres

rgbKey

Byte[]

Clé secrète à utiliser pour l’algorithme AES. La taille de la clé doit être de 128, 192 ou 256 bits.

rgbIV

Byte[]

Vecteur d’initialisation à utiliser pour l’algorithme AES.

Retours

ICryptoTransform

Objet chiffreur AES symétrique.

Exceptions

ArgumentNullException

rgbKey a la valeur null.

ArgumentException

rgbKey n’est pas une taille valide pour cet algorithme.

- ou -

rgbIV la taille ne correspond pas à la taille de bloc pour cet algorithme.

CryptographicException

rgbKey est une clé faible connue pour cet algorithme et ne peut pas être utilisée.

- ou -

rgbIV a la valeur null.

Remarques

Utilisez cette méthode pour chiffrer un message, puis utilisez la CreateDecryptor surcharge avec la même signature pour déchiffrer le résultat de cette méthode.

Note

Si vous avez créé l’objet AesCng à l’aide d’une clé persistante existante et que vous souhaitez utiliser cette clé lors du chiffrement du message, vous souhaitez définir la propriété, puis appeler la IV surcharge sans CreateEncryptor() paramètre à la place ; sinon, l’utilisation de cette méthode crée une clé éphémère comme spécifié par le rgbKey paramètre.