SymmetricAlgorithm Sınıf

Tanım

Simetrik algoritmaların tüm uygulamalarının devralınması gereken soyut temel sınıfı temsil eder.

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
SymmetricAlgorithm
Türetilmiş
Öznitelikler
Uygulamalar

Ö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

SymmetricAlgorithm()

SymmetricAlgorithm sınıfının yeni bir örneğini başlatır.

Alanlar

BlockSizeValue

Şifreleme işleminin blok boyutunu (bit cinsinden) temsil eder.

FeedbackSizeValue

Şifreleme işleminin bit cinsinden geri bildirim boyutunu temsil eder.

IVValue

Simetrik algoritma için başlatma vektörlerini (IV) temsil eder.

KeySizeValue

Simetrik algoritma tarafından kullanılan gizli anahtarın bit cinsinden boyutunu temsil eder.

KeyValue

Simetrik algoritmanın gizli anahtarını temsil eder.

LegalBlockSizesValue

Simetrik algoritma tarafından desteklenen blok boyutlarını bit cinsinden belirtir.

LegalKeySizesValue

Simetrik algoritma tarafından desteklenen anahtar boyutlarını bit cinsinden belirtir.

ModeValue

Simetrik algoritmada kullanılan şifreleme modunu temsil eder.

PaddingValue

Simetrik algoritmada kullanılan doldurma modunu temsil eder.

Özellikler

BlockSize

Şifreleme işleminin blok boyutunu bit cinsinden alır veya ayarlar.

FeedbackSize

Şifreleme Geri Bildirimi (CFB) ve Çıkış Geri Bildirimi (OFB) şifreleme modları için şifreleme işleminin bit cinsinden geri bildirim boyutunu alır veya ayarlar.

IV

Simetrik algoritma için başlatma vektörlerini (IV) alır veya ayarlar.

Key

Simetrik algoritmanın gizli anahtarını alır veya ayarlar.

KeySize

Simetrik algoritma tarafından kullanılan gizli anahtarın boyutunu bit cinsinden alır veya ayarlar.

LegalBlockSizes

Simetrik algoritma tarafından desteklenen blok boyutlarını bit cinsinden alır.

LegalKeySizes

Simetrik algoritma tarafından desteklenen anahtar boyutlarını bit cinsinden alır.

Mode

Simetrik algoritmanın çalışma modunu alır veya ayarlar.

Padding

Simetrik algoritmada kullanılan doldurma modunu alır veya ayarlar.

Yöntemler

Clear()

sınıfı tarafından SymmetricAlgorithm kullanılan tüm kaynakları serbest bırakır.

Create()
Geçersiz.
Geçersiz.

Simetrik algoritmayı gerçekleştirmek için kullanılan varsayılan bir şifreleme nesnesi oluşturur.

Create(String)
Geçersiz.

Simetrik algoritmayı gerçekleştirmek için kullanılan belirtilen şifreleme nesnesini oluşturur.

CreateDecryptor()

Geçerli Key özellik ve başlatma vektörünü ()IV içeren bir simetrik şifre çözücü nesnesi oluşturur.

CreateDecryptor(Byte[], Byte[])

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Key özellik ve başlatma vektörünü ()IV içeren bir simetrik decryptor nesnesi oluşturur.

CreateEncryptor()

Geçerli Key özellik ve başlatma vektörünü (IV ) içeren simetrik bir şifreleme nesnesi oluşturur.

CreateEncryptor(Byte[], Byte[])

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen Key özellik ve başlatma vektörünü (IV ) içeren bir simetrik şifreleme nesnesi oluşturur.

DecryptCbc(Byte[], Byte[], PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini çözer.

DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini çözer.

DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini belirtilen arabelleğe çözer.

DecryptCfb(Byte[], Byte[], PaddingMode, Int32)

Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini çözer.

DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)

Belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini çözer.

DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

CfB modunu belirtilen doldurma modu ve geri bildirim boyutuyla kullanarak verilerin şifresini belirtilen arabelleğe çözer.

DecryptEcb(Byte[], PaddingMode)

Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini çözer.

DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)

Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini çözer.

DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözer.

Dispose()

SymmetricAlgorithm sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.

Dispose(Boolean)

SymmetricAlgorithm tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

EncryptCbc(Byte[], Byte[], PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verileri şifreler.

EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verileri şifreler.

EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verileri belirtilen arabelleğe şifreler.

EncryptCfb(Byte[], Byte[], PaddingMode, Int32)

CFB modunu kullanarak verileri belirtilen doldurma modu ve geri bildirim boyutuyla şifreler.

EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)

CFB modunu kullanarak verileri belirtilen doldurma modu ve geri bildirim boyutuyla şifreler.

EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

CfB modunu belirtilen doldurma modu ve geri bildirim boyutuyla kullanarak verileri belirtilen arabelleğe şifreler.

EncryptEcb(Byte[], PaddingMode)

EcB modunu kullanarak verileri belirtilen doldurma moduyla şifreler.

EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)

EcB modunu kullanarak verileri belirtilen doldurma moduyla şifreler.

EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)

EcB modunu belirtilen doldurma moduyla kullanarak verileri belirtilen arabelleğe şifreler.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Finalize()

Bu üye öğesini geçersiz kılar Finalize()ve bu konuda daha eksiksiz belgeler bulunabilir.

Object atık toplama tarafından geri kazanılmadan önce kaynakları boşaltmaya ve diğer temizleme işlemlerini gerçekleştirmeye Object çalışmasına izin verir.

GenerateIV()

Türetilmiş bir sınıfta geçersiz kılındığında, algoritma için kullanılacak rastgele bir başlatma vektöru (IV) oluşturur.

GenerateKey()

Türetilmiş bir sınıfta geçersiz kılındığında, algoritma için kullanılacak rastgele bir anahtar (Key) oluşturur.

GetCiphertextLengthCbc(Int32, PaddingMode)

CBC modunda belirli bir doldurma modu ve düz metin uzunluğu ile bir şifre metninin uzunluğunu alır.

GetCiphertextLengthCfb(Int32, PaddingMode, Int32)

CFB modunda belirli bir doldurma modu ve düz metin uzunluğu ile bir şifre metninin uzunluğunu alır.

GetCiphertextLengthEcb(Int32, PaddingMode)

EcB modunda belirli bir doldurma modu ve düz metin uzunluğu ile bir şifreleme metninin uzunluğunu alır.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TryDecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini belirtilen arabellekte çözmeyi dener.

TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma moduyla CBC modunu kullanarak verilerin şifresini belirtilen arabelleğe çözmeyi dener.

TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)

CfB modunu belirtilen doldurma modu ve geri bildirim boyutuyla kullanarak verilerin şifresini belirtilen arabellekte çözmeyi dener.

TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma modu ve geri bildirim boyutuyla CFB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözmeyi dener.

TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini belirtilen arabellekte çözmeyi dener.

TryDecryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma moduyla ECB modunu kullanarak verilerin şifresini belirtilen arabelleğe çözmeyi dener.

TryEncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)

Belirtilen doldurma moduyla CBC modunu kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.

TryEncryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen doldurma moduyla CBC modunu kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.

TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)

CfB modunu belirtilen doldurma modu ve geri bildirim boyutuyla kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.

TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, CFB modunu belirtilen doldurma modu ve geri bildirim boyutuyla kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.

TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

EcB modunu belirtilen doldurma moduyla kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.

TryEncryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)

Türetilmiş bir sınıfta geçersiz kılındığında, ecb modunu belirtilen doldurma moduyla kullanarak verileri belirtilen arabelleğe şifrelemeyi dener.

ValidKeySize(Int32)

Belirtilen anahtar boyutunun geçerli algoritma için geçerli olup olmadığını belirler.

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

SymmetricAlgorithm tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

Şunlara uygulanır

Ayrıca bkz.