SymmetricAlgorithm Classe

Riferimento

Definizione

Spazio dei nomi:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.Primitives.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origine:: SymmetricAlgorithm.cs

Origine:: SymmetricAlgorithm.cs

Origine:: SymmetricAlgorithm.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 astratta dalla quale devono ereditare tutte le implementazioni di algoritmi simmetrici.

public ref class SymmetricAlgorithm abstract : IDisposable

public abstract class SymmetricAlgorithm : IDisposable

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class SymmetricAlgorithm : IDisposable

type SymmetricAlgorithm = class
    interface IDisposable

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

Public MustInherit Class SymmetricAlgorithm
Implements IDisposable

Ereditarietà: Object
SymmetricAlgorithm

Derivato: System.Security.Cryptography.Aes

System.Security.Cryptography.DES

System.Security.Cryptography.RC2

System.Security.Cryptography.Rijndael

System.Security.Cryptography.TripleDES

Attributi: ComVisibleAttribute

Implementazioni: IDisposable

Esempio

Nell'esempio di codice seguente viene usata la classe con la proprietà specificata e il Aes vettore di inizializzazione (IV) per crittografare un file specificato da inNamee restituisce il risultato crittografato al file specificato da outName.Key I desKey parametri e desIV del metodo sono matrici a 8 byte. Per eseguire questo esempio, è necessario disporre del pacchetto di crittografia elevato installato.

void EncryptData( String^ inName, String^ outName, array<Byte>^aesKey, array<Byte>^aesIV )
{
   
   //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.

   Aes^ aes = Aes::Create();

   CryptoStream^ encStream = gcnew CryptoStream( fout,aes->CreateEncryptor( aesKey, aesIV ),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();
   fout->Close();
   fin->Close();
}

private static void EncryptData(string inName, string outName, byte[] aesKey, byte[] aesIV)
 {
     //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.

     Aes aes = Aes.Create();
     CryptoStream encStream = new CryptoStream(fout, aes.CreateEncryptor(aesKey, aesIV), 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();
     fout.Close();
     fin.Close();
 }

Private Shared Sub EncryptData(inName As String, outName As String, _
rijnKey() As Byte, rijnIV() 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 'Total length of the input file.
    Dim len As Integer 'This is the number of bytes to be written at a time.
    'Creates the default implementation, which is RijndaelManaged.
    Dim rijn As SymmetricAlgorithm = SymmetricAlgorithm.Create()
    Dim encStream As New CryptoStream(fout, _
       rijn.CreateEncryptor(rijnKey, rijnIV), 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 = Convert.ToInt32(rdlen + len)
        Console.WriteLine("{0} bytes processed", rdlen)
    End While
    
    encStream.Close()
fout.Close()
fin.Close()
End Sub

Commenti

Le classi che derivano dalla SymmetricAlgorithm classe usano una modalità di concatenamento denominata concatenamento a blocchi di crittografia (CBC), che richiede una chiave () e un vettore di inizializzazione (Key IV) per eseguire trasformazioni crittografiche sui dati. Per decrittografare i dati crittografati usando una delle SymmetricAlgorithm classi, è necessario impostare la proprietà e la proprietà sullo stesso valore usato per la Key IV crittografia. Per un algoritmo simmetrico utile, la chiave privata deve essere nota solo al mittente e al ricevitore.

Aes, DES, RC2e TripleDES sono implementazioni di algoritmi simmetrici.

Si noti che quando si usano classi derivate, non è sufficiente, dal punto di vista della sicurezza, per forzare semplicemente una Garbage Collection dopo aver completato l'uso dell'oggetto. È necessario chiamare in modo esplicito il Clear metodo sull'oggetto per zero tutti i dati sensibili all'interno dell'oggetto prima che venga rilasciato. Si noti che Garbage Collection non esce dal contenuto degli oggetti raccolti, ma contrassegna semplicemente la memoria come disponibile per la riallocazione. Pertanto, i dati contenuti all'interno di un oggetto Garbage Collection possono comunque essere presenti nell'heap di memoria non allocata. Nel caso di oggetti crittografici, questi dati potrebbero contenere informazioni riservate, ad esempio dati chiave o un blocco di testo normale.

Tutte le classi crittografiche in .NET Framework che contengono dati sensibili implementano un Clear metodo. Quando viene chiamato, il Clear metodo sovrascrive tutti i dati sensibili all'interno dell'oggetto con zero e quindi rilascia l'oggetto in modo che possa essere garbage collection in modo sicuro. Quando l'oggetto è stato zero e rilasciato, è necessario chiamare il metodo con il Disposedisposing parametro impostato per True eliminare tutte le risorse gestite e non gestite associate all'oggetto.

Note per gli implementatori

Quando si eredita dalla classe, è necessario eseguire l'override SymmetricAlgorithm dei membri seguenti: CreateDecryptor(Byte[], Byte[]), CreateEncryptor(Byte[], Byte[]), GenerateIV()e GenerateKey().

Costruttori

SymmetricAlgorithm()

Inizializza una nuova istanza della classe SymmetricAlgorithm.

Campi

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

Proprietà

BlockSize	Ottiene o imposta la dimensione in bit del blocco dell'operazione di crittografia.
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).
IV	Ottiene o imposta il vettore di inizializzazione (IV) per l'algoritmo simmetrico.
Key	Ottiene o imposta la chiave segreta per l'algoritmo simmetrico.
KeySize	Ottiene o imposta la dimensione in bit della chiave segreta utilizzata dall'algoritmo simmetrico.
LegalBlockSizes	Ottiene le dimensioni in bit dei blocchi supportate dall'algoritmo simmetrico.
LegalKeySizes	Ottiene le dimensioni in bit delle chiavi supportate dall'algoritmo simmetrico.
Mode	Ottiene o imposta la modalità di funzionamento dell'algoritmo simmetrico.
Padding	Ottiene o imposta la modalità di riempimento usata nell'algoritmo simmetrico.

Metodi

Clear()	Rilascia tutte le risorse usate dalla classe SymmetricAlgorithm.
Create()	Obsoleti. Obsoleti. Crea l'oggetto di crittografia predefinito usato per eseguire l'algoritmo simmetrico.
Create(String)	Obsoleti. Crea l'oggetto di crittografia specificato usato per eseguire l'algoritmo simmetrico.
CreateDecryptor()	Crea un oggetto di decrittografia simmetrica con la proprietà Key corrente e il vettore di inizializzazione IV.
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.
CreateEncryptor()	Crea un oggetto di crittografia simmetrica con la proprietà Key corrente e il vettore di inizializzazione IV.
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.
DecryptCbc(Byte[], Byte[], PaddingMode)	Decrittografa i dati usando la modalità CBC con la modalità di riempimento specificata.
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Decrittografa i dati usando la modalità CBC con la modalità di riempimento specificata.
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Decrittografa i dati nel buffer specificato usando la modalità CBC con la modalità di riempimento specificata.
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)	Decrittografa i dati usando la modalità MDF con la modalità di riempimento e le dimensioni del feedback specificate.
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.
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.
DecryptEcb(Byte[], PaddingMode)	Decrittografa i dati usando la modalità BCE con la modalità di riempimento specificata.
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Decrittografa i dati usando la modalità BCE con la modalità di riempimento specificata.
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Decrittografa i dati nel buffer specificato usando la modalità BCE con la modalità di riempimento specificata.
Dispose()	Rilascia tutte le risorse usate dall'istanza corrente della classe SymmetricAlgorithm.
Dispose(Boolean)	Rilascia le risorse non gestite usate da SymmetricAlgorithm e, facoltativamente, le risorse gestite.
EncryptCbc(Byte[], Byte[], PaddingMode)	Crittografa i dati usando la modalità CBC con la modalità di riempimento specificata.
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Crittografa i dati usando la modalità CBC con la modalità di riempimento specificata.
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Crittografa i dati nel buffer specificato usando la modalità CBC con la modalità di riempimento specificata.
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.
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.
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.
EncryptEcb(Byte[], PaddingMode)	Crittografa i dati usando la modalità BCE con la modalità di riempimento specificata.
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Crittografa i dati usando la modalità BCE con la modalità di riempimento specificata.
EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Crittografa i dati nel buffer specificato usando la modalità BCE con la modalità di riempimento specificata.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Finalize()	Questo membro esegue l'override di Finalize(). L'argomento corrispondente può contenere documentazione più completa. Consente a un oggetto Object di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto Object stesso venga recuperato dalla procedura di Garbage Collection.
GenerateIV()	Quando è sottoposto a override in una classe derivata, genera un vettore di inizializzazione casuale IV da usare per l'algoritmo.
GenerateKey()	Quando è sottoposto a override in una classe derivata, genera una chiave casuale Key da usare per l'algoritmo.
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.
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.
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.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
ValidKeySize(Int32)	Determina se la dimensione specificata della chiave è valida per l'algoritmo corrente.

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.

Si applica a

Vedi anche

servizi crittografici

Condividi tramite