SymmetricAlgorithm Sınıf

Tanım

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

Devralma

Object

SymmetricAlgorithm

Türetilmiş

System.Security.Cryptography.Aes

System.Security.Cryptography.DES

System.Security.Cryptography.RC2

System.Security.Cryptography.Rijndael

System.Security.Cryptography.TripleDES

Öznitelikler

ComVisibleAttribute

Uygulamalar

IDisposable

Örnekler

Aşağıdaki kod örneği, tarafından inNamebelirtilen bir dosyayı şifrelemek için belirtilen Key özellik ve başlatma vektörünü (IV) içeren sınıfını kullanır Aes ve tarafından belirtilen outNamedosyaya şifrelenmiş sonucun çıkışını yapar. desKey yönteminin ve desIV parametreleri 8 baytlık dizilerdir. Bu örneği çalıştırmak için yüksek şifreleme paketinin yüklü olması gerekir.

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

Açıklamalar

sınıfından SymmetricAlgorithm türetilen sınıflar, veriler üzerinde şifreleme dönüştürmeleri gerçekleştirmek için anahtar () ve başlatma vektörü (Key) gerektiren şifreleme bloğu zincirleme (IVCBC) adlı bir zincirleme modunu kullanır. Sınıflardan biri SymmetricAlgorithm kullanılarak şifrelenen verilerin şifresini çözmek için özelliğini ve IV özelliğini şifreleme için kullanılan değerlere ayarlamanız Key gerekir. Simetrik algoritmanın yararlı olması için gizli anahtarın yalnızca gönderen ve alıcı tarafından bilinmesi gerekir.

Aes, DES, RC2ve TripleDES simetrik algoritmaların uygulamalarıdır.

Türetilmiş sınıfları kullanırken, nesneyi kullanmayı bitirdikten sonra bir çöp toplamayı zorlamanın güvenlik açısından yeterli olmadığını unutmayın. Serbest bırakılmadan önce nesne içindeki hassas verileri sıfırlamak için nesnede yöntemini açıkça çağırmanız Clear gerekir. Atık toplamanın toplanan nesnelerin içeriğinin sıfırlanmadığını, yalnızca belleği yeniden konumlandırma için kullanılabilir olarak işaretlediğini unutmayın. Bu nedenle, atık olarak toplanan bir nesnenin içindeki veriler ayrılmamış bellekteki bellek yığınında hala bulunabilir. Şifreleme nesneleri söz konusu olduğunda, bu veriler anahtar verileri veya düz metin bloğu gibi hassas bilgiler içerebilir.

.NET Framework'te hassas verileri tutan tüm şifreleme sınıfları bir Clear yöntem uygular. çağrıldığında, Clear yöntem sıfırlarla nesne içindeki tüm hassas verilerin üzerine yazar ve sonra güvenli bir şekilde çöp toplanabilmesi için nesneyi serbest bırakır. Nesne sıfırlanıp serbest bırakıldığında, nesnesiyle disposing ilişkili tüm yönetilen ve yönetilmeyen kaynakları atmak için True parametresi ayarlanmış yöntemini çağırmanız Dispose gerekir.

Uygulayanlara Notlar

sınıfından SymmetricAlgorithm devraldığınızda, şu üyeleri geçersiz kılmanız gerekir: CreateDecryptor(Byte[], Byte[]), CreateEncryptor(Byte[], Byte[]), GenerateIV()ve GenerateKey().

Oluşturucular

Alanlar

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• Şifreleme Hizmetleri