TripleDES Класс

Ссылка

Определение

Пространство имен:: System.Security.Cryptography

Сборка:: System.Security.Cryptography.Algorithms.dll

Сборка:: System.Security.Cryptography.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Исходный код:: TripleDES.cs

Исходный код:: TripleDES.cs

Исходный код:: TripleDES.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет базовый класс для алгоритмов Triple DES, от которых должны наследоваться все реализации TripleDES.

public ref class TripleDES abstract : System::Security::Cryptography::SymmetricAlgorithm

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public abstract class TripleDES : System.Security.Cryptography.SymmetricAlgorithm

public abstract class TripleDES : System.Security.Cryptography.SymmetricAlgorithm

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TripleDES : System.Security.Cryptography.SymmetricAlgorithm

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type TripleDES = class
    inherit SymmetricAlgorithm

type TripleDES = class
    inherit SymmetricAlgorithm

[<System.Runtime.InteropServices.ComVisible(true)>]
type TripleDES = class
    inherit SymmetricAlgorithm

Public MustInherit Class TripleDES
Inherits SymmetricAlgorithm

Наследование: Object

SymmetricAlgorithm
TripleDES

Производный: System.Security.Cryptography.TripleDESCng

System.Security.Cryptography.TripleDESCryptoServiceProvider

Атрибуты: UnsupportedOSPlatformAttribute ComVisibleAttribute

Примеры

В следующем примере кода метод использует с TripleDESCryptoServiceProvider указанным ключом (Key) и вектором инициализации (IV) для шифрования файла, указанного параметром inName. Затем он выводит зашифрованный результат в файл, указанный параметром outName.

void EncryptData( String^ inName, String^ outName, array<Byte>^tdesKey, array<Byte>^tdesIV )
{
   
   //Create the file streams to handle the input and output files.
   FileStream^ fin = gcnew FileStream( inName,FileMode::Open,FileAccess::Read );
   FileStream^ fout = gcnew FileStream( outName,FileMode::OpenOrCreate,FileAccess::Write );
   fout->SetLength( 0 );
   
   //Create variables to help with read and write.
   array<Byte>^bin = gcnew array<Byte>(100);
   long rdlen = 0; //This is the total number of bytes written.

   long totlen = (long)fin->Length; //This is the total length of the input file.

   int len; //This is the number of bytes to be written at a time.

   TripleDESCryptoServiceProvider^ tdes = gcnew TripleDESCryptoServiceProvider;
   CryptoStream^ encStream = gcnew CryptoStream( fout,tdes->CreateEncryptor( tdesKey, tdesIV ),CryptoStreamMode::Write );
   Console::WriteLine( "Encrypting..." );
   
   //Read from the input file, then encrypt and write to the output file.
   while ( rdlen < totlen )
   {
      len = fin->Read( bin, 0, 100 );
      encStream->Write( bin, 0, len );
      rdlen = rdlen + len;
      Console::WriteLine( "{0} bytes processed", rdlen );
   }

   encStream->Close();
}

private static void EncryptData(string inName, string outName, byte[] tdesKey, byte[] tdesIV)
{
    //Create the file streams to handle the input and output files.
    FileStream fin = new FileStream(inName, FileMode.Open, FileAccess.Read);
    FileStream fout = new FileStream(outName, FileMode.OpenOrCreate, FileAccess.Write);
    fout.SetLength(0);

    //Create variables to help with read and write.
    byte[] bin = new byte[100]; //This is intermediate storage for the encryption.
    long rdlen = 0;              //This is the total number of bytes written.
    long totlen = fin.Length;    //This is the total length of the input file.
    int len;                     //This is the number of bytes to be written at a time.

    TripleDESCryptoServiceProvider tdes = new TripleDESCryptoServiceProvider();
    CryptoStream encStream = new CryptoStream(fout, tdes.CreateEncryptor(tdesKey, tdesIV), CryptoStreamMode.Write);

    Console.WriteLine("Encrypting...");

    //Read from the input file, then encrypt and write to the output file.
    while(rdlen < totlen)
    {
        len = fin.Read(bin, 0, 100);
        encStream.Write(bin, 0, len);
        rdlen = rdlen + len;
        Console.WriteLine("{0} bytes processed", rdlen);
    }

    encStream.Close();
}

Private Shared Sub EncryptData(inName As String, outName As String, _
   tdesKey() As Byte, tdesIV() As Byte)
   
    'Create the file streams to handle the input and output files.
    Dim fin As New FileStream(inName, FileMode.Open, FileAccess.Read)
    Dim fout As New FileStream(outName, FileMode.OpenOrCreate, _
       FileAccess.Write)
    fout.SetLength(0)
        
    'Create variables to help with read and write.
    Dim bin(100) As Byte 'This is intermediate storage for the encryption.
    Dim rdlen As Long = 0 'This is the total number of bytes written.
    Dim totlen As Long = fin.Length 'This is the total length of the input file.
    Dim len As Integer 'This is the number of bytes to be written at a time.
    Dim tdes As New TripleDESCryptoServiceProvider()
    Dim encStream As New CryptoStream(fout, _
       tdes.CreateEncryptor(tdesKey, tdesIV), CryptoStreamMode.Write)
        
    Console.WriteLine("Encrypting...")
        
    'Read from the input file, then encrypt and write to the output file.
    While rdlen < totlen
        len = fin.Read(bin, 0, 100)
        encStream.Write(bin, 0, len)
        rdlen = rdlen + len
        Console.WriteLine("{0} bytes processed", rdlen)
    End While
        
    encStream.Close()
End Sub

Расшифровка может обрабатываться таким же образом; используйте CreateDecryptor вместо CreateEncryptor. Для его расшифровки необходимо использовать тот же ключ (Key) и вектор инициализации (IV), который используется для шифрования файла.

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

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

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

TripleDES()

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

Поля

BlockSizeValue	Представляет размер блока криптографической операции (в битах). (Унаследовано от SymmetricAlgorithm)
FeedbackSizeValue	Представляет размер порции данных обратной связи для криптографической операции (в битах). (Унаследовано от SymmetricAlgorithm)
IVValue	Представляет вектор инициализации (IV) для алгоритма симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
KeySizeValue	Представляет размер секретного ключа (в битах), используемого алгоритмом симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
KeyValue	Представляет секретный ключ для алгоритма симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
LegalBlockSizesValue	Задает размеры блоков (в битах), которые поддерживаются алгоритмом симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
LegalKeySizesValue	Задает размеры ключа (в битах), которые поддерживаются алгоритмом симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
ModeValue	Представляет режим шифрования, используемый в алгоритме симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
PaddingValue	Представляет режим заполнения, используемый в алгоритме симметричного шифрования. (Унаследовано от SymmetricAlgorithm)

Свойства

BlockSize	Возвращает или задает размер блока криптографической операции (в битах). (Унаследовано от SymmetricAlgorithm)
FeedbackSize	Возвращает или задает размер ответа криптографической операции (в битах) для режимов шифрования "Обратная связь по шифру" (CFB) и "Выходная обратная связь" (OFB). (Унаследовано от SymmetricAlgorithm)
IV	Получает или задает вектор инициализации (IV) для алгоритма симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
Key	Получает или задает секретный ключ для алгоритма TripleDES.
KeySize	Получает или задает размер секретного ключа (в битах), используемого алгоритмом симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
LegalBlockSizes	Получает размеры блоков (в битах), которые поддерживаются алгоритмом симметричного шифрования.
LegalBlockSizes	Получает размеры блоков (в битах), которые поддерживаются алгоритмом симметричного шифрования. (Унаследовано от SymmetricAlgorithm)
LegalKeySizes	Возвращает размеры ключа (в битах), которые поддерживаются симметричным алгоритмом.
LegalKeySizes	Возвращает размеры ключа (в битах), которые поддерживаются симметричным алгоритмом. (Унаследовано от SymmetricAlgorithm)
Mode	Возвращает или задает режим функционирования симметричного алгоритма. (Унаследовано от SymmetricAlgorithm)
Padding	Возвращает или задает режим заполнения, используемый в симметричном алгоритме. (Унаследовано от SymmetricAlgorithm)

Методы

Clear()	Освобождает все ресурсы, используемые классом SymmetricAlgorithm. (Унаследовано от SymmetricAlgorithm)
Create()	Создает экземпляр криптографического объекта для выполнения алгоритма TripleDES.
Create(String)	Устаревшие.. Создает экземпляр криптографического объекта для выполнения заданной реализации алгоритма TripleDES.
CreateDecryptor()	Создает симметричный объект-дешифратор с текущим свойством Key и вектором инициализации (IV). (Унаследовано от SymmetricAlgorithm)
CreateDecryptor(Byte[], Byte[])	При переопределении в производном классе создает объект-дешифратор для алгоритма симметричного шифрования с заданным свойством Key и вектором инициализации (IV). (Унаследовано от SymmetricAlgorithm)
CreateEncryptor()	Создает симметричный объект-шифратор с текущим свойством Key и вектором инициализации (IV). (Унаследовано от SymmetricAlgorithm)
CreateEncryptor(Byte[], Byte[])	При переопределении в производном классе создает объект-шифратор для алгоритма симметричного шифрования с заданным свойством Key и вектором инициализации (IV). (Унаследовано от SymmetricAlgorithm)
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), используемый для алгоритма. (Унаследовано от SymmetricAlgorithm)
GenerateKey()	При переопределении в производном классе генерирует случайный ключ (Key), используемый для алгоритма. (Унаследовано от SymmetricAlgorithm)
GetCiphertextLengthCbc(Int32, PaddingMode)	Возвращает длину зашифрованного текста с заданным режимом заполнения и длину открытого текста в режиме CBC. (Унаследовано от SymmetricAlgorithm)
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)	Возвращает длину зашифрованного текста с заданным режимом заполнения и длину открытого текста в режиме CFB. (Унаследовано от SymmetricAlgorithm)
GetCiphertextLengthEcb(Int32, PaddingMode)	Возвращает длину зашифрованного текста с заданным режимом заполнения и длину открытого текста в режиме ЕЦБ. (Унаследовано от SymmetricAlgorithm)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsWeakKey(Byte[])	Определяет, является ли указанный ключ слабым.
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)

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

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