Прочитать на английском

Поделиться через


TripleDESCryptoServiceProvider Класс

Определение

Внимание!

Derived cryptographic types are obsolete. Use the Create method on the base type instead.

Определяет объект-оболочку для доступа к реализации алгоритма TripleDES, предоставляемой поставщиком служб шифрования (CSP). Этот класс не наследуется.

C#
public sealed class TripleDESCryptoServiceProvider : System.Security.Cryptography.TripleDES
C#
[System.Obsolete("Derived cryptographic types are obsolete. Use the Create method on the base type instead.", DiagnosticId="SYSLIB0021", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class TripleDESCryptoServiceProvider : System.Security.Cryptography.TripleDES
C#
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class TripleDESCryptoServiceProvider : System.Security.Cryptography.TripleDES
Наследование
TripleDESCryptoServiceProvider
Атрибуты

Примеры

В следующем примере кода создается TripleDESCryptoServiceProvider объект и он используется для шифрования и расшифровки данных в файле .

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

class TrippleDESCSPSample
{

    static void Main()
    {
        try
        {
            // Create a new TripleDESCryptoServiceProvider object
            // to generate a key and initialization vector (IV).
            TripleDESCryptoServiceProvider tDESalg = new TripleDESCryptoServiceProvider();

            // Create a string to encrypt.
            string sData = "Here is some data to encrypt.";
            string FileName = "CText.txt";

            // Encrypt text to a file using the file name, key, and IV.
            EncryptTextToFile(sData, FileName, tDESalg.Key, tDESalg.IV);

            // Decrypt the text from a file using the file name, key, and IV.
            string Final = DecryptTextFromFile(FileName, tDESalg.Key, tDESalg.IV);

            // Display the decrypted string to the console.
            Console.WriteLine(Final);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }

    public static void EncryptTextToFile(String Data, String FileName, byte[] Key, byte[] IV)
    {
        try
        {
            // Create or open the specified file.
            FileStream fStream = File.Open(FileName,FileMode.OpenOrCreate);

            // Create a CryptoStream using the FileStream
            // and the passed key and initialization vector (IV).
            CryptoStream cStream = new CryptoStream(fStream,
                new TripleDESCryptoServiceProvider().CreateEncryptor(Key,IV),
                CryptoStreamMode.Write);

            // Create a StreamWriter using the CryptoStream.
            StreamWriter sWriter = new StreamWriter(cStream);

            // Write the data to the stream
            // to encrypt it.
            sWriter.WriteLine(Data);

            // Close the streams and
            // close the file.
            sWriter.Close();
            cStream.Close();
            fStream.Close();
        }
        catch(CryptographicException e)
        {
            Console.WriteLine("A Cryptographic error occurred: {0}", e.Message);
        }
        catch(UnauthorizedAccessException  e)
        {
            Console.WriteLine("A file access error occurred: {0}", e.Message);
        }
    }

    public static string DecryptTextFromFile(String FileName, byte[] Key, byte[] IV)
    {
        try
        {
            // Create or open the specified file.
            FileStream fStream = File.Open(FileName, FileMode.OpenOrCreate);

            // Create a CryptoStream using the FileStream
            // and the passed key and initialization vector (IV).
            CryptoStream cStream = new CryptoStream(fStream,
                new TripleDESCryptoServiceProvider().CreateDecryptor(Key,IV),
                CryptoStreamMode.Read);

            // Create a StreamReader using the CryptoStream.
            StreamReader sReader = new StreamReader(cStream);

            // Read the data from the stream
            // to decrypt it.
            string val = sReader.ReadLine();

            // Close the streams and
            // close the file.
            sReader.Close();
            cStream.Close();
            fStream.Close();

            // Return the string.
            return val;
        }
        catch(CryptographicException e)
        {
            Console.WriteLine("A Cryptographic error occurred: {0}", e.Message);
            return null;
        }
        catch(UnauthorizedAccessException  e)
        {
            Console.WriteLine("A file access error occurred: {0}", e.Message);
            return null;
        }
    }
}

В следующем примере кода создается TripleDESCryptoServiceProvider объект и он используется для шифрования и расшифровки данных в памяти.

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

class TrippleDESCSPSample
{

    static void Main()
    {
        try
        {
            // Create a new TripleDESCryptoServiceProvider object
            // to generate a key and initialization vector (IV).
            TripleDESCryptoServiceProvider tDESalg = new TripleDESCryptoServiceProvider();

            // Create a string to encrypt.
            string sData = "Here is some data to encrypt.";

            // Encrypt the string to an in-memory buffer.
            byte[] Data = EncryptTextToMemory(sData, tDESalg.Key, tDESalg.IV);

            // Decrypt the buffer back to a string.
            string Final = DecryptTextFromMemory(Data, tDESalg.Key, tDESalg.IV);

            // Display the decrypted string to the console.
            Console.WriteLine(Final);
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }

    public static byte[] EncryptTextToMemory(string Data,  byte[] Key, byte[] IV)
    {
        try
        {
            // Create a MemoryStream.
            MemoryStream mStream = new MemoryStream();

            // Create a CryptoStream using the MemoryStream
            // and the passed key and initialization vector (IV).
            CryptoStream cStream = new CryptoStream(mStream,
                new TripleDESCryptoServiceProvider().CreateEncryptor(Key, IV),
                CryptoStreamMode.Write);

            // Convert the passed string to a byte array.
            byte[] toEncrypt = new ASCIIEncoding().GetBytes(Data);

            // Write the byte array to the crypto stream and flush it.
            cStream.Write(toEncrypt, 0, toEncrypt.Length);
            cStream.FlushFinalBlock();

            // Get an array of bytes from the
            // MemoryStream that holds the
            // encrypted data.
            byte[] ret = mStream.ToArray();

            // Close the streams.
            cStream.Close();
            mStream.Close();

            // Return the encrypted buffer.
            return ret;
        }
        catch(CryptographicException e)
        {
            Console.WriteLine("A Cryptographic error occurred: {0}", e.Message);
            return null;
        }
    }

    public static string DecryptTextFromMemory(byte[] Data,  byte[] Key, byte[] IV)
    {
        try
        {
            // Create a new MemoryStream using the passed
            // array of encrypted data.
            MemoryStream msDecrypt = new MemoryStream(Data);

            // Create a CryptoStream using the MemoryStream
            // and the passed key and initialization vector (IV).
            CryptoStream csDecrypt = new CryptoStream(msDecrypt,
                new TripleDESCryptoServiceProvider().CreateDecryptor(Key, IV),
                CryptoStreamMode.Read);

            // Create buffer to hold the decrypted data.
            byte[] fromEncrypt = new byte[Data.Length];

            // Read the decrypted data out of the crypto stream
            // and place it into the temporary buffer.
            csDecrypt.Read(fromEncrypt, 0, fromEncrypt.Length);

            //Convert the buffer into a string and return it.
            return new ASCIIEncoding().GetString(fromEncrypt);
        }
        catch(CryptographicException e)
        {
            Console.WriteLine("A Cryptographic error occurred: {0}", e.Message);
            return null;
        }
    }
}

Комментарии

Этот алгоритм поддерживает длину ключа от 128 до 192 бит с шагом в 64 бита.

Примечание

Доступен новый алгоритм симметричного шифрования Advanced Encryption Standard (AES). Рассмотрите AesCryptoServiceProvider возможность использования класса вместо TripleDESCryptoServiceProvider класса . Используйте TripleDESCryptoServiceProvider только для совместимости с устаревшими приложениями и данными.

Конструкторы

TripleDESCryptoServiceProvider()
Устаревшие..

Инициализирует новый экземпляр класса TripleDESCryptoServiceProvider.

Поля

BlockSizeValue
Устаревшие..

Представляет размер блока криптографической операции (в битах).

(Унаследовано от SymmetricAlgorithm)
FeedbackSizeValue
Устаревшие..

Представляет размер порции данных обратной связи для криптографической операции (в битах).

(Унаследовано от SymmetricAlgorithm)
IVValue
Устаревшие..

Представляет вектор инициализации (IV) для алгоритма симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
KeySizeValue
Устаревшие..

Представляет размер секретного ключа (в битах), используемого алгоритмом симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
KeyValue
Устаревшие..

Представляет секретный ключ для алгоритма симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
LegalBlockSizesValue
Устаревшие..

Задает размеры блоков (в битах), которые поддерживаются алгоритмом симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
LegalKeySizesValue
Устаревшие..

Задает размеры ключа (в битах), которые поддерживаются алгоритмом симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
ModeValue
Устаревшие..

Представляет режим шифрования, используемый в алгоритме симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
PaddingValue
Устаревшие..

Представляет режим заполнения, используемый в алгоритме симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)

Свойства

BlockSize
Устаревшие..

Возвращает или задает размер блока криптографической операции (в битах).

BlockSize
Устаревшие..

Возвращает или задает размер блока криптографической операции (в битах).

(Унаследовано от SymmetricAlgorithm)
FeedbackSize
Устаревшие..

Возвращает или задает размер ответа криптографической операции (в битах) для режимов шифрования "Обратная связь по шифру" (CFB) и "Выходная обратная связь" (OFB).

FeedbackSize
Устаревшие..

Возвращает или задает размер ответа криптографической операции (в битах) для режимов шифрования "Обратная связь по шифру" (CFB) и "Выходная обратная связь" (OFB).

(Унаследовано от SymmetricAlgorithm)
IV
Устаревшие..

Получает или задает вектор инициализации (IV) для алгоритма симметричного шифрования.

IV
Устаревшие..

Получает или задает вектор инициализации (IV) для алгоритма симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
Key
Устаревшие..

Получает или задает секретный ключ для алгоритма TripleDES.

Key
Устаревшие..

Получает или задает секретный ключ для алгоритма TripleDES.

(Унаследовано от TripleDES)
KeySize
Устаревшие..

Возвращает или задает размер секретного ключа в битах.

KeySize
Устаревшие..

Получает или задает размер секретного ключа (в битах), используемого алгоритмом симметричного шифрования.

(Унаследовано от SymmetricAlgorithm)
LegalBlockSizes
Устаревшие..

Получает размеры блоков (в битах), которые поддерживаются алгоритмом симметричного шифрования.

LegalBlockSizes
Устаревшие..

Получает размеры блоков (в битах), которые поддерживаются алгоритмом симметричного шифрования.

(Унаследовано от TripleDES)
LegalKeySizes
Устаревшие..

Возвращает размеры ключа (в битах), которые поддерживаются симметричным алгоритмом.

LegalKeySizes
Устаревшие..

Возвращает размеры ключа (в битах), которые поддерживаются симметричным алгоритмом.

(Унаследовано от TripleDES)
Mode
Устаревшие..

Возвращает или задает режим функционирования симметричного алгоритма.

Mode
Устаревшие..

Возвращает или задает режим функционирования симметричного алгоритма.

(Унаследовано от SymmetricAlgorithm)
Padding
Устаревшие..

Возвращает или задает режим заполнения, используемый в симметричном алгоритме.

Padding
Устаревшие..

Возвращает или задает режим заполнения, используемый в симметричном алгоритме.

(Унаследовано от SymmetricAlgorithm)

Методы

Clear()
Устаревшие..

Освобождает все ресурсы, используемые классом SymmetricAlgorithm.

(Унаследовано от SymmetricAlgorithm)
CreateDecryptor()
Устаревшие..

Создает симметричный объект-дешифратор с текущим свойством Key и вектором инициализации (IV).

CreateDecryptor()
Устаревшие..

Создает симметричный объект-дешифратор с текущим свойством Key и вектором инициализации (IV).

(Унаследовано от SymmetricAlgorithm)
CreateDecryptor(Byte[], Byte[])
Устаревшие..

Создает объект-дешифратор для алгоритма симметричного шифрования TripleDES с заданным ключом (Key) и вектором инициализации (IV).

CreateEncryptor()
Устаревшие..

Создает симметричный объект-шифратор с текущим свойством Key и вектором инициализации (IV).

CreateEncryptor()
Устаревшие..

Создает симметричный объект-шифратор с текущим свойством Key и вектором инициализации (IV).

(Унаследовано от SymmetricAlgorithm)
CreateEncryptor(Byte[], Byte[])
Устаревшие..

Создает объект-шифратор для алгоритма симметричного шифрования TripleDES с заданным ключом (Key) и вектором инициализации (IV).

DecryptCbc(Byte[], Byte[], PaddingMode)
Устаревшие..

Расшифровывает данные с помощью режима CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)
Устаревшие..

Расшифровывает данные с помощью режима CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)
Устаревшие..

Расшифровывает данные в указанный буфер, используя режим CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)
Устаревшие..

Расшифровывает данные с помощью режима CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)
Устаревшие..

Расшифровывает данные с помощью режима CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

Расшифровывает данные в указанный буфер, используя режим CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
DecryptEcb(Byte[], PaddingMode)
Устаревшие..

Расшифровывает данные с помощью режима ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)
Устаревшие..

Расшифровывает данные с помощью режима ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)
Устаревшие..

Расшифровывает данные в указанный буфер, используя режим ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
Dispose()
Устаревшие..

Освобождает все ресурсы, используемые текущим экземпляром класса SymmetricAlgorithm.

(Унаследовано от SymmetricAlgorithm)
Dispose(Boolean)
Устаревшие..

Освобождает неуправляемые ресурсы, используемые объектом SymmetricAlgorithm, а при необходимости освобождает также управляемые ресурсы.

(Унаследовано от SymmetricAlgorithm)
EncryptCbc(Byte[], Byte[], PaddingMode)
Устаревшие..

Шифрует данные с помощью режима CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)
Устаревшие..

Шифрует данные с помощью режима CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)
Устаревшие..

Шифрует данные в указанный буфер, используя режим CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
EncryptCfb(Byte[], Byte[], PaddingMode, Int32)
Устаревшие..

Шифрует данные с помощью режима CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)
Устаревшие..

Шифрует данные с помощью режима CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

Шифрует данные в указанный буфер, используя режим CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
EncryptEcb(Byte[], PaddingMode)
Устаревшие..

Шифрует данные с помощью режима ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)
Устаревшие..

Шифрует данные с помощью режима ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)
Устаревшие..

Шифрует данные в указанный буфер, используя режим ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
Equals(Object)
Устаревшие..

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GenerateIV()
Устаревшие..

Создает случайный вектор инициализации (IV), используемый для данного алгоритма.

GenerateKey()
Устаревшие..

Генерирует случайный ключ (Key) для использования данным алгоритмом.

GetCiphertextLengthCbc(Int32, PaddingMode)
Устаревшие..

Возвращает длину зашифрованного текста с заданным режимом заполнения и длину открытого текста в режиме CBC.

(Унаследовано от SymmetricAlgorithm)
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)
Устаревшие..

Возвращает длину зашифрованного текста с заданным режимом заполнения и длину открытого текста в режиме CFB.

(Унаследовано от SymmetricAlgorithm)
GetCiphertextLengthEcb(Int32, PaddingMode)
Устаревшие..

Возвращает длину зашифрованного текста с заданным режимом заполнения и длину открытого текста в режиме ЕЦБ.

(Унаследовано от SymmetricAlgorithm)
GetHashCode()
Устаревшие..

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()
Устаревшие..

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()
Устаревшие..

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()
Устаревшие..

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
TryDecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)
Устаревшие..

Пытается расшифровать данные в указанный буфер, используя режим CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

При переопределении в производном классе пытается расшифровать данные в указанный буфер, используя режим CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)
Устаревшие..

Пытается расшифровать данные в указанный буфер, используя режим CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)
Устаревшие..

При переопределении в производном классе пытается расшифровать данные в указанный буфер, используя режим CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

Пытается расшифровать данные в указанный буфер, используя режим ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
TryDecryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

При переопределении в производном классе пытается расшифровать данные в указанный буфер, используя режим ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
TryEncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)
Устаревшие..

Пытается зашифровать данные в указанный буфер, используя режим CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
TryEncryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

При переопределении в производном классе пытается зашифровать данные в указанный буфер, используя режим CBC с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)
Устаревшие..

Пытается зашифровать данные в указанный буфер, используя режим CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)
Устаревшие..

При переопределении в производном классе пытается зашифровать данные в указанный буфер, используя режим CFB с указанным режимом заполнения и размером обратной связи.

(Унаследовано от SymmetricAlgorithm)
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

Пытается зашифровать данные в указанный буфер, используя режим ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
TryEncryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)
Устаревшие..

При переопределении в производном классе пытается зашифровать данные в указанный буфер, используя режим ECB с указанным режимом заполнения.

(Унаследовано от SymmetricAlgorithm)
ValidKeySize(Int32)
Устаревшие..

Определяет, является ли заданный размер ключа допустимым для текущего алгоритма.

(Унаследовано от SymmetricAlgorithm)

Явные реализации интерфейса

IDisposable.Dispose()

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Устаревшие..

Освобождает неуправляемые ресурсы, используемые объектом SymmetricAlgorithm, а при необходимости освобождает также управляемые ресурсы.

(Унаследовано от SymmetricAlgorithm)

Применяется к

Продукт Версии (Устарело)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5 (6, 7, 8, 9)
.NET Framework 1.1, 2.0, 3.0, 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 2.0, 2.1

См. также раздел