CryptoProvider.BlockSize Właściwość

Definicja

Przestrzeń nazw:

System.Security.RightsManagement

Zestaw:

WindowsBase.dll

Pobiera rozmiar bloku szyfrowania w bajtach.

public:
 property int BlockSize { int get(); };

public int BlockSize { get; }

member this.BlockSize : int

Public ReadOnly Property BlockSize As Integer

Wartość właściwości

Int32

Rozmiar bloku szyfrowania w bajtach. Domyślny rozmiar bloku dla standardu AES (Advanced Encryption Standard) to 8.

Przykłady

W poniższym przykładzie pokazano, jak używać BlockSize właściwości w konwertowaniu danych w postaci zwykłego tekstu na zaszyfrowane dane tekstowe.

WriteStatus("   Binding the author's UseLicense and");
WriteStatus("       obtaining the CryptoProvider.");
using (CryptoProvider cryptoProvider =
            authorsUseLicense.Bind(_secureEnv))
{
    WriteStatus("   Writing encrypted content.");
    using (Stream clearTextStream =
                File.OpenRead(contentFile) )
    {
        using (Stream cryptoTextStream =
                    File.OpenWrite(encryptedFile))
        {
            // Write the length of the source content file
            // as the first four bytes of the encrypted file.
            cryptoTextStream.Write(
                BitConverter.GetBytes(clearTextStream.Length),
                0, sizeof(Int32));

            // Allocate clearText buffer.
            byte[] clearTextBlock =
                new byte[cryptoProvider.BlockSize];

            // Encrypt clearText to cryptoText block by block.
            for(;;)
            {   // Read clearText block.
                int readCount = ReliableRead(
                                    clearTextStream,
                                    clearTextBlock, 0 ,
                                    cryptoProvider.BlockSize);
                // readCount of zero is end of data.
                if (readCount == 0)  break; // for

                // Encrypt clearText to cryptoText.
                byte[] cryptoTextBlock =
                    cryptoProvider.Encrypt(clearTextBlock);

                // Write cryptoText block.
                cryptoTextStream.Write(cryptoTextBlock, 0,
                                       cryptoTextBlock.Length);
            }
            WriteStatus("   Closing '" + encryptedFilename + "'.");
        }// end:using (Stream cryptoTextStream =
    }// end:using (Stream clearTextStream =
}// end:using (CryptoProvider cryptoProvider =
WriteStatus("   Done - Content encryption complete.");

WriteStatus("   Binding the author's UseLicense and")
WriteStatus("       obtaining the CryptoProvider.")
Using cryptoProvider As CryptoProvider = authorsUseLicense.Bind(_secureEnv)
    WriteStatus("   Writing encrypted content.")
    Using clearTextStream As Stream = File.OpenRead(contentFile)
        Using cryptoTextStream As Stream = File.OpenWrite(encryptedFile)
            ' Write the length of the source content file
            ' as the first four bytes of the encrypted file.
            Dim expression As Int32
            cryptoTextStream.Write(BitConverter.GetBytes(clearTextStream.Length), 0, Len(expression))

            ' Allocate clearText buffer.
            Dim clearTextBlock(cryptoProvider.BlockSize - 1) As Byte

            ' Encrypt clearText to cryptoText block by block.
            Do
                Dim readCount As Integer = ReliableRead(clearTextStream, clearTextBlock, 0, cryptoProvider.BlockSize)
                ' readCount of zero is end of data.
                If readCount = 0 Then ' for
                    Exit Do
                End If

                ' Encrypt clearText to cryptoText.
                Dim cryptoTextBlock() As Byte = cryptoProvider.Encrypt(clearTextBlock)

                ' Write cryptoText block.
                cryptoTextStream.Write(cryptoTextBlock, 0, cryptoTextBlock.Length)
            Loop
            WriteStatus("   Closing '" & encryptedFilename & "'.")
        End Using ' end:using (Stream cryptoTextStream =
    End Using ' end:using (Stream clearTextStream =
End Using ' end:using (CryptoProvider cryptoProvider =
WriteStatus("   Done - Content encryption complete.")

Uwagi

Bufory clearText i cipherText przekazywane do Encrypt i Decrypt muszą mieć długość n*BlockSize bajtów, gdzie "n" jest liczbą całkowitą większą lub równą 1.

Jeśli CanMergeBlocks jest to false, bufory przekazywane muszą Encrypt być taką samą długością, jak bufory przekazywane do Decrypt.

Jeśli CanMergeBlocks jest to true, bufory przekazywane Encrypt do mogą być inną długością niż bufory przekazywane do Decrypt (wszystkie rozmiary buforów muszą nadal być wielokrotną BlockSize długością bajtów).

Wartość A BlockSize z 1 wskazuje, że szyfr jest szyfrem strumienia; BlockSize wartość 2 lub większa wskazuje szyfr blokowy.