Lire en anglais

Partager via


Aes Classe

Définition

Représente la classe de base abstraite dont toutes les implémentations d’AES (Advanced Encryption Standard) doivent hériter.

C#
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public abstract class Aes : System.Security.Cryptography.SymmetricAlgorithm
C#
public abstract class Aes : System.Security.Cryptography.SymmetricAlgorithm
Héritage
Dérivé
Attributs

Exemples

L’exemple suivant montre comment chiffrer et déchiffrer des exemples de données à l’aide de la Aes classe .

C#
using System;
using System.IO;
using System.Security.Cryptography;

namespace Aes_Example
{
    class AesExample
    {
        public static void Main()
        {
            string original = "Here is some data to encrypt!";

            // Create a new instance of the Aes
            // class.  This generates a new key and initialization
            // vector (IV).
            using (Aes myAes = Aes.Create())
            {

                // Encrypt the string to an array of bytes.
                byte[] encrypted = EncryptStringToBytes_Aes(original, myAes.Key, myAes.IV);

                // Decrypt the bytes to a string.
                string roundtrip = DecryptStringFromBytes_Aes(encrypted, myAes.Key, myAes.IV);

                //Display the original data and the decrypted data.
                Console.WriteLine("Original:   {0}", original);
                Console.WriteLine("Round Trip: {0}", roundtrip);
            }
        }
        static byte[] EncryptStringToBytes_Aes(string plainText, byte[] Key, byte[] IV)
        {
            // Check arguments.
            if (plainText == null || plainText.Length <= 0)
                throw new ArgumentNullException("plainText");
            if (Key == null || Key.Length <= 0)
                throw new ArgumentNullException("Key");
            if (IV == null || IV.Length <= 0)
                throw new ArgumentNullException("IV");
            byte[] encrypted;

            // Create an Aes object
            // with the specified key and IV.
            using (Aes aesAlg = Aes.Create())
            {
                aesAlg.Key = Key;
                aesAlg.IV = IV;

                // Create an encryptor to perform the stream transform.
                ICryptoTransform encryptor = aesAlg.CreateEncryptor(aesAlg.Key, aesAlg.IV);

                // Create the streams used for encryption.
                using (MemoryStream msEncrypt = new MemoryStream())
                {
                    using (CryptoStream csEncrypt = new CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write))
                    {
                        using (StreamWriter swEncrypt = new StreamWriter(csEncrypt))
                        {
                            //Write all data to the stream.
                            swEncrypt.Write(plainText);
                        }
                        encrypted = msEncrypt.ToArray();
                    }
                }
            }

            // Return the encrypted bytes from the memory stream.
            return encrypted;
        }

        static string DecryptStringFromBytes_Aes(byte[] cipherText, byte[] Key, byte[] IV)
        {
            // Check arguments.
            if (cipherText == null || cipherText.Length <= 0)
                throw new ArgumentNullException("cipherText");
            if (Key == null || Key.Length <= 0)
                throw new ArgumentNullException("Key");
            if (IV == null || IV.Length <= 0)
                throw new ArgumentNullException("IV");

            // Declare the string used to hold
            // the decrypted text.
            string plaintext = null;

            // Create an Aes object
            // with the specified key and IV.
            using (Aes aesAlg = Aes.Create())
            {
                aesAlg.Key = Key;
                aesAlg.IV = IV;

                // Create a decryptor to perform the stream transform.
                ICryptoTransform decryptor = aesAlg.CreateDecryptor(aesAlg.Key, aesAlg.IV);

                // Create the streams used for decryption.
                using (MemoryStream msDecrypt = new MemoryStream(cipherText))
                {
                    using (CryptoStream csDecrypt = new CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read))
                    {
                        using (StreamReader srDecrypt = new StreamReader(csDecrypt))
                        {

                            // Read the decrypted bytes from the decrypting stream
                            // and place them in a string.
                            plaintext = srDecrypt.ReadToEnd();
                        }
                    }
                }
            }

            return plaintext;
        }
    }
}

Constructeurs

Aes()

Initialise une nouvelle instance de la classe Aes.

Champs

BlockSizeValue

Représente la taille de bloc, en bits, de l'opération de chiffrement.

(Hérité de SymmetricAlgorithm)
FeedbackSizeValue

Représente la taille des commentaires, en bits, de l'opération de chiffrement.

(Hérité de SymmetricAlgorithm)
IVValue

Représente le vecteur d'initialisation (IV) pour l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
KeySizeValue

Représente la taille, en bits, de la clé secrète utilisée par l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
KeyValue

Représente la clé secrète pour l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
LegalBlockSizesValue

Spécifie les tailles de bloc, en octets, prises en charge par l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
LegalKeySizesValue

Spécifie les tailles de clé, en octets, prises en charge par l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
ModeValue

Représente le mode de chiffrement utilisé dans l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
PaddingValue

Représente le mode de remplissage utilisé dans l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)

Propriétés

BlockSize

Obtient ou définit la taille de bloc, en bits, de l'opération de chiffrement.

(Hérité de SymmetricAlgorithm)
FeedbackSize

Obtient ou définit la taille des commentaires, en bits, de l’opération de chiffrement pour les modes de chiffrement CFB (Cipher Feedback) et OFB (Output Feedback).

(Hérité de SymmetricAlgorithm)
IV

Obtient ou définit le vecteur d'initialisation (IV) pour l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
Key

Obtient ou définit la clé secrète pour l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
KeySize

Obtient ou définit la taille, en bits, de la clé secrète utilisée par l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
LegalBlockSizes

Obtient les tailles de bloc, en octets, prises en charge par l'algorithme symétrique.

LegalBlockSizes

Obtient les tailles de bloc, en octets, prises en charge par l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
LegalKeySizes

Obtient les tailles de clé, en octets, prises en charge par l'algorithme symétrique.

LegalKeySizes

Obtient les tailles de clé, en octets, prises en charge par l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
Mode

Obtient ou définit le mode de fonctionnement pour l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)
Padding

Obtient ou définit le mode de remplissage utilisé dans l'algorithme symétrique.

(Hérité de SymmetricAlgorithm)

Méthodes

Clear()

Libère toutes les ressources utilisées par la classe SymmetricAlgorithm.

(Hérité de SymmetricAlgorithm)
Create()

Crée un objet de chiffrement qui permet d’exécuter l’algorithme symétrique.

Create(String)
Obsolète.

Crée un objet de chiffrement qui spécifie l’implémentation d’AES à utiliser pour exécuter l’algorithme symétrique.

CreateDecryptor()

Crée un objet déchiffreur symétrique avec la propriété Key et le vecteur d'initialisation (IV) actuels.

(Hérité de SymmetricAlgorithm)
CreateDecryptor(Byte[], Byte[])

En cas de substitution dans une classe dérivée, crée un objet déchiffreur symétrique avec la propriété Key spécifiée et le vecteur d'initialisation (IV).

(Hérité de SymmetricAlgorithm)
CreateEncryptor()

Crée un objet chiffreur symétrique avec la propriété Key et le vecteur d'initialisation (IV) actuels.

(Hérité de SymmetricAlgorithm)
CreateEncryptor(Byte[], Byte[])

En cas de substitution dans une classe dérivée, crée un objet chiffreur symétrique avec la propriété Key spécifiée et le vecteur d'initialisation (IV).

(Hérité de SymmetricAlgorithm)
DecryptCbc(Byte[], Byte[], PaddingMode)

Déchiffre les données en utilisant le mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)

Déchiffre les données en utilisant le mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

Déchiffre les données dans la mémoire tampon spécifiée, à l’aide du mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)

Déchiffre les données à l’aide du mode CFB avec le mode de remplissage et la taille des commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)

Déchiffre les données à l’aide du mode CFB avec le mode de remplissage et la taille des commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Déchiffre les données dans la mémoire tampon spécifiée, à l’aide du mode CFB avec le mode de remplissage et la taille des commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
DecryptEcb(Byte[], PaddingMode)

Déchiffre les données à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)

Déchiffre les données à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

Déchiffre les données dans la mémoire tampon spécifiée, à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
Dispose()

Libère toutes les ressources utilisées par l'instance actuelle de la classe SymmetricAlgorithm.

(Hérité de SymmetricAlgorithm)
Dispose(Boolean)

Libère les ressources non managées utilisées par SymmetricAlgorithm et libère éventuellement les ressources managées.

(Hérité de SymmetricAlgorithm)
EncryptCbc(Byte[], Byte[], PaddingMode)

Chiffre les données à l’aide du mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)

Chiffre les données à l’aide du mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

Chiffre les données dans la mémoire tampon spécifiée, en utilisant le mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
EncryptCfb(Byte[], Byte[], PaddingMode, Int32)

Chiffre les données à l’aide du mode CFB avec le mode de remplissage et la taille de commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)

Chiffre les données à l’aide du mode CFB avec le mode de remplissage et la taille de commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Chiffre les données dans la mémoire tampon spécifiée, à l’aide du mode CFB avec le mode de remplissage et la taille de commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
EncryptEcb(Byte[], PaddingMode)

Chiffre les données à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)

Chiffre les données à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

Chiffre les données dans la mémoire tampon spécifiée, à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GenerateIV()

En cas de substitution dans une classe dérivée, génère un vecteur d'initialisation aléatoire (IV) à utiliser pour l'algorithme.

(Hérité de SymmetricAlgorithm)
GenerateKey()

En cas de substitution dans une classe dérivée, génère une clé aléatoire (Key) à utiliser pour l'algorithme.

(Hérité de SymmetricAlgorithm)
GetCiphertextLengthCbc(Int32, PaddingMode)

Obtient la longueur d’un texte de chiffrement avec un mode de remplissage donné et une longueur en texte clair en mode CBC.

(Hérité de SymmetricAlgorithm)
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)

Obtient la longueur d’un texte de chiffrement avec un mode de remplissage donné et une longueur en texte clair en mode CFB.

(Hérité de SymmetricAlgorithm)
GetCiphertextLengthEcb(Int32, PaddingMode)

Obtient la longueur d’un texte de chiffrement avec un mode de remplissage donné et une longueur en texte clair en mode BCE.

(Hérité de SymmetricAlgorithm)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TryDecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)

Tente de déchiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

En cas de substitution dans une classe dérivée, tente de déchiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)

Tente de déchiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode CFB avec le mode de remplissage et la taille de commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)

En cas de substitution dans une classe dérivée, tente de déchiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode CFB avec le mode de remplissage et la taille de commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Tente de déchiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
TryDecryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

En cas de substitution dans une classe dérivée, tente de déchiffrer les données dans la mémoire tampon spécifiée, en utilisant le mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
TryEncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)

Tente de chiffrer des données dans la mémoire tampon spécifiée, à l’aide du mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
TryEncryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

En cas de substitution dans une classe dérivée, tente de chiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode CBC avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)

Tente de chiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode CFB avec le mode de remplissage et la taille des commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)

En cas de substitution dans une classe dérivée, tente de chiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode CFB avec le mode de remplissage et la taille de commentaires spécifiés.

(Hérité de SymmetricAlgorithm)
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Tente de chiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
TryEncryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

En cas de substitution dans une classe dérivée, tente de chiffrer les données dans la mémoire tampon spécifiée, à l’aide du mode BCE avec le mode de remplissage spécifié.

(Hérité de SymmetricAlgorithm)
ValidKeySize(Int32)

Détermine si la taille de clé spécifiée est valide pour l'algorithme en cours.

(Hérité de SymmetricAlgorithm)

Implémentations d’interfaces explicites

IDisposable.Dispose()

Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code.

Libère les ressources non managées utilisées par SymmetricAlgorithm et libère éventuellement les ressources managées.

(Hérité de SymmetricAlgorithm)

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1