TripleDES Classe

Riferimento

Definizione

Spazio dei nomi:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.Algorithms.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origine:: TripleDES.cs

Origine:: TripleDES.cs

Origine:: TripleDES.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta la classe base per gli algoritmi 3DES (Triple Data Encryption Standard) da cui devono derivare tutte le implementazioni di 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

Ereditarietà: Object

SymmetricAlgorithm
TripleDES

Derivato: System.Security.Cryptography.TripleDESCng

System.Security.Cryptography.TripleDESCryptoServiceProvider

Attributi: UnsupportedOSPlatformAttribute ComVisibleAttribute

Esempio

Il metodo di esempio di codice seguente usa TripleDESCryptoServiceProvider con la chiave specificata () e il vettore di inizializzazione (Key IV) per crittografare un file specificato da inName. Restituisce quindi il risultato crittografato al file specificato da 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

La decrittografia può essere gestita nello stesso modo; usare CreateDecryptor anziché CreateEncryptor. La stessa chiave () e il vettore di inizializzazione (Key IV) usati per crittografare il file deve essere usato per decrittografarlo.

Commenti

TripleDES usa tre iterazioni successive dell'algoritmo DES . Può usare due o tre chiavi a 56 bit.

Nota

È disponibile un algoritmo di crittografia simmetrica più recente, Advanced Encryption Standard (AES). È consigliabile usare la Aes classe e le relative classi derivate anziché la TripleDES classe. Usare TripleDES solo per la compatibilità con applicazioni e dati legacy.

Questo algoritmo supporta le lunghezze delle chiavi da 128 bit a 192 bit in incrementi di 64 bit.

Costruttori

TripleDES()

Inizializza una nuova istanza della classe TripleDES.

Campi

BlockSizeValue	Rappresenta la dimensione in bit del blocco dell'operazione di crittografia. (Ereditato da SymmetricAlgorithm)
FeedbackSizeValue	Rappresenta la dimensione in bit della quantità di informazioni raccolte dell'operazione di crittografia. (Ereditato da SymmetricAlgorithm)
IVValue	Rappresenta il vettore di inizializzazione IV per l'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
KeySizeValue	Rappresenta la dimensione in bit della chiave privata usata dall'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
KeyValue	Rappresenta la chiave privata per l'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
LegalBlockSizesValue	Specifica le dimensioni in bit dei blocchi supportate dall'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
LegalKeySizesValue	Specifica le dimensioni in bit delle chiavi supportate dall'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
ModeValue	Rappresenta la modalità di crittografia usata nell'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
PaddingValue	Rappresenta la modalità di riempimento usata nell'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)

Proprietà

BlockSize	Ottiene o imposta la dimensione in bit del blocco dell'operazione di crittografia. (Ereditato da SymmetricAlgorithm)
FeedbackSize	Ottiene o imposta le dimensioni delle informazioni raccolte dell'operazione di crittografia per le modalità di crittografia CFB (Cipher Feedback) e OFB (Output Feedback). (Ereditato da SymmetricAlgorithm)
IV	Ottiene o imposta il vettore di inizializzazione (IV) per l'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
Key	Ottiene o imposta la chiave privata per l'algoritmo TripleDES.
KeySize	Ottiene o imposta la dimensione in bit della chiave segreta utilizzata dall'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
LegalBlockSizes	Ottiene le dimensioni in bit dei blocchi supportate dall'algoritmo simmetrico.
LegalBlockSizes	Ottiene le dimensioni in bit dei blocchi supportate dall'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
LegalKeySizes	Ottiene le dimensioni in bit delle chiavi supportate dall'algoritmo simmetrico.
LegalKeySizes	Ottiene le dimensioni in bit delle chiavi supportate dall'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
Mode	Ottiene o imposta la modalità di funzionamento dell'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)
Padding	Ottiene o imposta la modalità di riempimento usata nell'algoritmo simmetrico. (Ereditato da SymmetricAlgorithm)

Metodi

Clear()	Rilascia tutte le risorse usate dalla classe SymmetricAlgorithm. (Ereditato da SymmetricAlgorithm)
Create()	Crea un'istanza di un oggetto di crittografia per eseguire l'algoritmo TripleDES.
Create(String)	Obsoleti. Consente di creare un'istanza di un oggetto di crittografia per eseguire l'implementazione specificata dell'algoritmo TripleDES.
CreateDecryptor()	Crea un oggetto di decrittografia simmetrica con la proprietà Key corrente e il vettore di inizializzazione IV. (Ereditato da SymmetricAlgorithm)
CreateDecryptor(Byte[], Byte[])	Quando è sottoposto a override in una classe derivata, crea un oggetto di decrittografia simmetrica con la proprietà Key e il vettore di inizializzazione IV specificati. (Ereditato da SymmetricAlgorithm)
CreateEncryptor()	Crea un oggetto di crittografia simmetrica con la proprietà Key corrente e il vettore di inizializzazione IV. (Ereditato da SymmetricAlgorithm)
CreateEncryptor(Byte[], Byte[])	Quando è sottoposto a override in una classe derivata, crea un oggetto di crittografia simmetrica con la proprietà Key e il vettore di inizializzazione IV specificati. (Ereditato da SymmetricAlgorithm)
DecryptCbc(Byte[], Byte[], PaddingMode)	Decrittografa i dati usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Decrittografa i dati usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Decrittografa i dati nel buffer specificato usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)	Decrittografa i dati usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	Decrittografa i dati usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Decrittografa i dati nel buffer specificato usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
DecryptEcb(Byte[], PaddingMode)	Decrittografa i dati usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Decrittografa i dati usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Decrittografa i dati nel buffer specificato usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
Dispose()	Rilascia tutte le risorse usate dall'istanza corrente della classe SymmetricAlgorithm. (Ereditato da SymmetricAlgorithm)
Dispose(Boolean)	Rilascia le risorse non gestite usate da SymmetricAlgorithm e, facoltativamente, le risorse gestite. (Ereditato da SymmetricAlgorithm)
EncryptCbc(Byte[], Byte[], PaddingMode)	Crittografa i dati usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Crittografa i dati usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Crittografa i dati nel buffer specificato usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
EncryptCfb(Byte[], Byte[], PaddingMode, Int32)	Crittografa i dati usando la modalità MDF con la modalità di riempimento e le dimensioni dei commenti e suggerimenti specificati. (Ereditato da SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	Crittografa i dati usando la modalità MDF con la modalità di riempimento e le dimensioni dei commenti e suggerimenti specificati. (Ereditato da SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Crittografa i dati nel buffer specificato usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
EncryptEcb(Byte[], PaddingMode)	Crittografa i dati usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Crittografa i dati usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Crittografa i dati nel buffer specificato usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GenerateIV()	Quando è sottoposto a override in una classe derivata, genera un vettore di inizializzazione casuale IV da usare per l'algoritmo. (Ereditato da SymmetricAlgorithm)
GenerateKey()	Quando è sottoposto a override in una classe derivata, genera una chiave casuale Key da usare per l'algoritmo. (Ereditato da SymmetricAlgorithm)
GetCiphertextLengthCbc(Int32, PaddingMode)	Ottiene la lunghezza di un testo di crittografia con una determinata modalità di riempimento e lunghezza del testo non crittografato in modalità CBC. (Ereditato da SymmetricAlgorithm)
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)	Ottiene la lunghezza di un testo di crittografia con una determinata modalità di riempimento e lunghezza del testo non crittografato in modalità TLS. (Ereditato da SymmetricAlgorithm)
GetCiphertextLengthEcb(Int32, PaddingMode)	Ottiene la lunghezza di un testo di crittografia con una determinata modalità di riempimento e lunghezza di testo non crittografato in modalità BCE. (Ereditato da SymmetricAlgorithm)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsWeakKey(Byte[])	Determina se la chiave specificata è debole.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TryDecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)	Tenta di decrittografare i dati nel buffer specificato usando la modalità CBC con la modalità spaziatura interna specificata. (Ereditato da SymmetricAlgorithm)
TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando sottoposto a override in una classe derivata, tenta di decrittografare i dati nel buffer specificato usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Tenta di decrittografare i dati nel buffer specificato, usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Quando sottoposto a override in una classe derivata, tenta di decrittografare i dati nel buffer specificato, usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Tenta di decrittografare i dati nel buffer specificato usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
TryDecryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando sottoposto a override in una classe derivata, tenta di decrittografare i dati nel buffer specificato, usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
TryEncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)	Tenta di crittografare i dati nel buffer specificato usando la modalità CBC con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
TryEncryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando sottoposto a override in una classe derivata, tenta di crittografare i dati nel buffer specificato usando la modalità CBC con la modalità spaziatura interna specificata. (Ereditato da SymmetricAlgorithm)
TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Tenta di crittografare i dati nel buffer specificato, usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Quando sottoposto a override in una classe derivata, tenta di crittografare i dati nel buffer specificato, usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate. (Ereditato da SymmetricAlgorithm)
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Tenta di crittografare i dati nel buffer specificato usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
TryEncryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando sottoposto a override in una classe derivata, tenta di crittografare i dati nel buffer specificato, usando la modalità BCE con la modalità di riempimento specificata. (Ereditato da SymmetricAlgorithm)
ValidKeySize(Int32)	Determina se la dimensione specificata della chiave è valida per l'algoritmo corrente. (Ereditato da SymmetricAlgorithm)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

Rilascia le risorse non gestite usate da SymmetricAlgorithm e, facoltativamente, le risorse gestite.

(Ereditato da SymmetricAlgorithm)

Si applica a

Condividi tramite