AesCryptoServiceProvider.CreateEncryptor Method

Definition

Namespace:

System.Security.Cryptography

Assemblies:

netstandard.dll, System.Security.Cryptography.dll

Creates a symmetric AES encryptor object.

Overloads

CreateEncryptor()	Creates a symmetric AES encryptor object using the current key and initialization vector (IV).
CreateEncryptor(Byte[], Byte[])	Creates a symmetric encryptor object using the specified key and initialization vector (IV).

CreateEncryptor()

Source:

AesCryptoServiceProvider.cs

Creates a symmetric AES encryptor object using the current key and initialization vector (IV).

C#

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

Returns

ICryptoTransform

A symmetric AES encryptor object.

CreateEncryptor(Byte[], Byte[])

Source:

AesCryptoServiceProvider.cs

Creates a symmetric encryptor object using the specified key and initialization vector (IV).

C#

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

Parameters

rgbKey

Byte[]

The secret key to use for the symmetric algorithm.

rgbIV

Byte[]

The initialization vector to use for the symmetric algorithm.

Returns

ICryptoTransform

A symmetric AES encryptor object.

Exceptions

ArgumentNullException

The key or iv parameter is null.

ArgumentException

key is invalid.

Examples

The following example shows how to use the AesCryptoServiceProvider.CreateEncryptor method to encrypt a message. This code example is part of a larger example provided for the AesCryptoServiceProvider class.

C#

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;
}

Remarks

See the code examples in the LegalKeySizes and LegalBlockSizes properties to determine the size of the key and iv parameters.