AesCryptoServiceProvider Klasse

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Core.dll

Führt symmetrische Verschlüsselung und Entschlüsselung mithilfe der CAPI-Implementierung (Cryptographic Application Programming Interfaces) des AES-Algorithmus (Advanced Encryption Standard) durch.

public ref class AesCryptoServiceProvider sealed : System::Security::Cryptography::Aes

public sealed class AesCryptoServiceProvider : System.Security.Cryptography.Aes

type AesCryptoServiceProvider = class
    inherit Aes

Public NotInheritable Class AesCryptoServiceProvider
Inherits Aes

Vererbung

Object

SymmetricAlgorithm

Aes

AesCryptoServiceProvider

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Beispieldaten mithilfe der AesCryptoServiceProvider Klasse verschlüsselt und entschlüsselt werden.

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 AesCryptoServiceProvider
            // class.  This generates a new key and initialization
            // vector (IV).
            using (AesCryptoServiceProvider myAes = new AesCryptoServiceProvider())
            {
                // 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 AesCryptoServiceProvider object
            // with the specified key and IV.
            using (AesCryptoServiceProvider aesAlg = new AesCryptoServiceProvider())
            {
                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 AesCryptoServiceProvider object
            // with the specified key and IV.
            using (AesCryptoServiceProvider aesAlg = new AesCryptoServiceProvider())
            {
                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;
        }
    }
}

Imports System.IO
Imports System.Security.Cryptography



Class AesExample

    Public Shared Sub Main()
        Dim original As String = "Here is some data to encrypt!"

        ' Create a new instance of the AesCryptoServiceProvider
        ' class.  This generates a new key and initialization 
        ' vector (IV).
        Using myAes As New AesCryptoServiceProvider()

            ' Encrypt the string to an array of bytes.
            Dim encrypted As Byte() = EncryptStringToBytes_Aes(original, myAes.Key, myAes.IV)

            ' Decrypt the bytes to a string.
            Dim roundtrip As String = 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)
        End Using

    End Sub

    Shared Function EncryptStringToBytes_Aes(ByVal plainText As String, ByVal Key() As Byte, ByVal IV() As Byte) As Byte() 
        ' Check arguments.
        If plainText Is Nothing OrElse plainText.Length <= 0 Then
            Throw New ArgumentNullException("plainText")
        End If
        If Key Is Nothing OrElse Key.Length <= 0 Then
            Throw New ArgumentNullException("Key")
        End If
        If IV Is Nothing OrElse IV.Length <= 0 Then
            Throw New ArgumentNullException("IV")
        End If
        Dim encrypted() As Byte
        
        ' Create an AesCryptoServiceProvider object
        ' with the specified key and IV.
        Using aesAlg As New AesCryptoServiceProvider()

            aesAlg.Key = Key
            aesAlg.IV = IV

            ' Create an encryptor to perform the stream transform.
            Dim encryptor As ICryptoTransform = aesAlg.CreateEncryptor(aesAlg.Key, aesAlg.IV)

            ' Create the streams used for encryption.
            Dim msEncrypt As New MemoryStream()
            Using csEncrypt As New CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write)
                Using swEncrypt As New StreamWriter(csEncrypt)
                    'Write all data to the stream.
                    swEncrypt.Write(plainText)
                End Using
                encrypted = msEncrypt.ToArray()

            End Using
        End Using

        ' Return the encrypted bytes from the memory stream.
        Return encrypted

    End Function 'EncryptStringToBytes_Aes

    Shared Function DecryptStringFromBytes_Aes(ByVal cipherText() As Byte,ByVal Key() As Byte, ByVal IV() As Byte) As String
        ' Check arguments.
        If cipherText Is Nothing OrElse cipherText.Length <= 0 Then
            Throw New ArgumentNullException("cipherText")
        End If
        If Key Is Nothing OrElse Key.Length <= 0 Then
            Throw New ArgumentNullException("Key")
        End If
        If IV Is Nothing OrElse IV.Length <= 0 Then
            Throw New ArgumentNullException("IV")
        End If
        ' Declare the string used to hold
        ' the decrypted text.
        Dim plaintext As String = Nothing

        ' Create an AesCryptoServiceProvider object
        ' with the specified key and IV.
        Using aesAlg As New AesCryptoServiceProvider()

            aesAlg.Key = Key
            aesAlg.IV = IV

            ' Create a decryptor to perform the stream transform.
            Dim decryptor As ICryptoTransform = aesAlg.CreateDecryptor(aesAlg.Key, aesAlg.IV)

            ' Create the streams used for decryption.
            Using msDecrypt As New MemoryStream(cipherText)

                Using csDecrypt As New CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read)

                    Using srDecrypt As New StreamReader(csDecrypt)

                        ' Read the decrypted bytes from the decrypting stream
                        ' and place them in a string.
                        plaintext = srDecrypt.ReadToEnd()
                    End Using
                End Using
            End Using
        End Using
        Return plaintext

    End Function 'DecryptStringFromBytes_Aes 
End Class

open System
open System.IO
open System.Security.Cryptography

let encryptStringToBytes_Aes (plainText: string, key : byte[], iv : byte[]) : byte[] =

    // Check arguments.
    if (isNull plainText || plainText.Length <= 0) then nullArg "plainText"
    if (isNull key || key.Length <= 0) then nullArg "key"
    if (isNull iv || iv.Length <= 0) then nullArg "iv"
    
    // Create an AesCryptoServiceProvider object
    // with the specified key and IV.
    use aesAlg = new AesCryptoServiceProvider()
    aesAlg.Key <- key
    aesAlg.IV <- iv

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

    // Create the streams used for encryption.
    use msEncrypt = new MemoryStream()
    use csEncrypt = new CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write)
    use swEncrypt = new StreamWriter(csEncrypt)
    
    //Write all data to the stream.
    swEncrypt.Write(plainText)
    swEncrypt.Flush()
    
    // Return the encrypted bytes from the memory stream.
    msEncrypt.ToArray()

let decryptStringFromBytes_Aes (cipherText : byte[], key : byte[], iv : byte[]) : string =

    // Check arguments.
    if (isNull cipherText || cipherText.Length <= 0) then nullArg "cipherText"
    if (isNull key || key.Length <= 0) then nullArg "key"
    if (isNull iv || iv.Length <= 0) then nullArg "iv"

    // Create an AesCryptoServiceProvider object
    // with the specified key and IV.
    use aesAlg = new AesCryptoServiceProvider()
    aesAlg.Key <- key
    aesAlg.IV <- iv

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

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

    // Read the decrypted bytes from the decrypting stream
    // and return the resulting string.
    srDecrypt.ReadToEnd()

[<EntryPoint>]
let main argv = 

    let original = "Here is some data to encrypt!"

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

    // Encrypt the string to an array of bytes.
    let encrypted = encryptStringToBytes_Aes(original, myAes.Key, myAes.IV)

    // Decrypt the bytes to a string.
    let 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)
    0

Konstruktoren

Name	Beschreibung
AesCryptoServiceProvider()	Initialisiert eine neue Instanz der AesCryptoServiceProvider-Klasse.

Felder

Name	Beschreibung
BlockSizeValue	Stellt die Blockgröße in Bits des kryptografischen Vorgangs dar. (Geerbt von SymmetricAlgorithm)
FeedbackSizeValue	Stellt die Feedbackgröße in Bits des kryptografischen Vorgangs dar. (Geerbt von SymmetricAlgorithm)
IVValue	Stellt den Initialisierungsvektor (IV) für den symmetrischen Algorithmus dar. (Geerbt von SymmetricAlgorithm)
KeySizeValue	Stellt die Größe des geheimen Schlüssels in Bits dar, der vom symmetrischen Algorithmus verwendet wird. (Geerbt von SymmetricAlgorithm)
KeyValue	Stellt den geheimen Schlüssel für den symmetrischen Algorithmus dar. (Geerbt von SymmetricAlgorithm)
LegalBlockSizesValue	Gibt die Blockgrößen in Bits an, die vom symmetrischen Algorithmus unterstützt werden. (Geerbt von SymmetricAlgorithm)
LegalKeySizesValue	Gibt die Schlüsselgrößen in Bits an, die vom symmetrischen Algorithmus unterstützt werden. (Geerbt von SymmetricAlgorithm)
ModeValue	Stellt den verschlüsselungsmodus dar, der im symmetrischen Algorithmus verwendet wird. (Geerbt von SymmetricAlgorithm)
PaddingValue	Stellt den Abstandsmodus dar, der im symmetrischen Algorithmus verwendet wird. (Geerbt von SymmetricAlgorithm)

Eigenschaften

Name	Beschreibung
BlockSize	Ruft die Blockgröße in Bits des kryptografischen Vorgangs ab oder legt sie fest. (Geerbt von SymmetricAlgorithm)
FeedbackSize	Ruft die Feedbackgröße in Bits des kryptografischen Vorgangs für die Verschlüsselungsrückmeldungsmodi (CFB) und Output Feedback (OFB) ab oder legt sie fest. (Geerbt von SymmetricAlgorithm)
IV	Dient zum Abrufen oder Festlegen des Initialisierungsvektors (IV) für den symmetrischen Algorithmus. (Geerbt von SymmetricAlgorithm)
Key	Ruft den symmetrischen Schlüssel ab, der für die Verschlüsselung und Entschlüsselung verwendet wird, oder legt diesen fest.
KeySize	Ruft die Größe des geheimen Schlüssels in Bits ab oder legt sie fest.
Mode	Ruft den Modus für den Betrieb des symmetrischen Algorithmus ab oder legt den Modus fest. (Geerbt von SymmetricAlgorithm)
Padding	Ruft den Abstandsmodus ab, der im symmetrischen Algorithmus verwendet wird, oder legt diesen fest. (Geerbt von SymmetricAlgorithm)

Methoden

Name	Beschreibung
Clear()	Gibt alle Ressourcen frei, die von der SymmetricAlgorithm-Klasse verwendet werden. (Geerbt von SymmetricAlgorithm)
CreateDecryptor()	Erstellt ein symmetrisches AES-Entschlüsselungsobjekt mithilfe des aktuellen Schlüssels und des Initialisierungsvektors (IV).
CreateDecryptor(Byte[], Byte[])	Erstellt ein symmetrisches AES-Entschlüsselungsobjekt mit dem angegebenen Schlüssel- und Initialisierungsvektor (IV).
CreateEncryptor()	Erstellt ein symmetrisches AES-Verschlüsselungsobjekt mithilfe des aktuellen Schlüssels und des Initialisierungsvektors (IV).
CreateEncryptor(Byte[], Byte[])	Erstellt ein symmetrisches Verschlüsselungsobjekt mit dem angegebenen Schlüssel- und Initialisierungsvektor (IV).
Dispose()	Gibt alle Ressourcen frei, die von der aktuellen Instanz der SymmetricAlgorithm Klasse verwendet werden. (Geerbt von SymmetricAlgorithm)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den SymmetricAlgorithm verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von SymmetricAlgorithm)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GenerateIV()	Generiert einen zufälligen Initialisierungsvektor (IV), der für den Algorithmus verwendet werden soll.
GenerateKey()	Generiert einen Zufallsschlüssel, der für den Algorithmus verwendet werden soll.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
ValidKeySize(Int32)	Bestimmt, ob die angegebene Schlüsselgröße für den aktuellen Algorithmus gültig ist. (Geerbt von SymmetricAlgorithm)