TripleDES Classe

Definizione

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à
Derivato
Attributi

Esempio

Il metodo di esempio di codice seguente usa TripleDESCryptoServiceProvider con la chiave specificata () e il vettore di inizializzazione (KeyIV) 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 (KeyIV) 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

Vedi anche