RC2CryptoServiceProvider Classe

Referência

Definição

Namespace:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.Csp.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cuidado

Derived cryptographic types are obsolete. Use the Create method on the base type instead.

Define um objeto wrapper para acessar a implementação do CSP (provedor de serviços de criptografia) do algoritmo RC2. Essa classe não pode ser herdada.

public ref class RC2CryptoServiceProvider sealed : System::Security::Cryptography::RC2

public sealed class RC2CryptoServiceProvider : System.Security.Cryptography.RC2

[System.Obsolete("Derived cryptographic types are obsolete. Use the Create method on the base type instead.", DiagnosticId="SYSLIB0021", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class RC2CryptoServiceProvider : System.Security.Cryptography.RC2

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class RC2CryptoServiceProvider : System.Security.Cryptography.RC2

type RC2CryptoServiceProvider = class
    inherit RC2

[<System.Obsolete("Derived cryptographic types are obsolete. Use the Create method on the base type instead.", DiagnosticId="SYSLIB0021", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type RC2CryptoServiceProvider = class
    inherit RC2

[<System.Runtime.InteropServices.ComVisible(true)>]
type RC2CryptoServiceProvider = class
    inherit RC2

Public NotInheritable Class RC2CryptoServiceProvider
Inherits RC2

Herança: Object

SymmetricAlgorithm

RC2
RC2CryptoServiceProvider

Atributos: ObsoleteAttribute ComVisibleAttribute

Exemplos

O exemplo de código a seguir criptografa e descriptografa uma cadeia de caracteres.

using System;
using System.IO;
using System.Text;
using System.Security.Cryptography;

namespace RC2CryptoServiceProvider_Examples
{
    class MyMainClass
    {
        public static void Main()
        {

            // Create a new instance of the RC2CryptoServiceProvider class
            // and automatically generate a Key and IV.
            RC2CryptoServiceProvider rc2CSP = new RC2CryptoServiceProvider();

            Console.WriteLine("Effective key size is {0} bits.", rc2CSP.EffectiveKeySize);

            // Get the key and IV.
            byte[] key = rc2CSP.Key;
            byte[] IV = rc2CSP.IV;

            // Get an encryptor.
            ICryptoTransform encryptor = rc2CSP.CreateEncryptor(key, IV);

            // Encrypt the data as an array of encrypted bytes in memory.
            MemoryStream msEncrypt = new MemoryStream();
            CryptoStream csEncrypt = new CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write);

            // Convert the data to a byte array.
            string original = "Here is some data to encrypt.";
            byte[] toEncrypt = Encoding.ASCII.GetBytes(original);

            // Write all data to the crypto stream and flush it.
            csEncrypt.Write(toEncrypt, 0, toEncrypt.Length);
            csEncrypt.FlushFinalBlock();

            // Get the encrypted array of bytes.
            byte[] encrypted = msEncrypt.ToArray();

            ///////////////////////////////////////////////////////
            // This is where the data could be transmitted or saved.
            ///////////////////////////////////////////////////////

            //Get a decryptor that uses the same key and IV as the encryptor.
            ICryptoTransform decryptor = rc2CSP.CreateDecryptor(key, IV);

            // Now decrypt the previously encrypted message using the decryptor
            // obtained in the above step.
            MemoryStream msDecrypt = new MemoryStream(encrypted);
            CryptoStream csDecrypt = new CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read);

            // Read the decrypted bytes from the decrypting stream
            // and place them in a StringBuilder class.

            StringBuilder roundtrip = new StringBuilder();

            int b = 0;

            do
            {
                b = csDecrypt.ReadByte();

                if (b != -1)
                {
                    roundtrip.Append((char)b);
                }
            } while (b != -1);

            // Display the original data and the decrypted data.
            Console.WriteLine("Original:   {0}", original);
            Console.WriteLine("Round Trip: {0}", roundtrip);
        }
    }
}

Imports System.IO
Imports System.Text
Imports System.Security.Cryptography



Module Crypto

    Sub Main()

        ' Create a new instance of the RC2CryptoServiceProvider class
        ' and automatically generate a Key and IV.
        Dim rc2CSP As New RC2CryptoServiceProvider()

        Console.WriteLine("Effective key size is {0} bits.", rc2CSP.EffectiveKeySize)

        ' Get the key and IV.
        Dim key As Byte() = rc2CSP.Key
        Dim IV As Byte() = rc2CSP.IV

        ' Get an encryptor.
        Dim encryptor As ICryptoTransform = rc2CSP.CreateEncryptor(key, IV)

        ' Encrypt the data as an array of encrypted bytes in memory.
        Dim msEncrypt As New MemoryStream()
        Dim csEncrypt As New CryptoStream(msEncrypt, encryptor, CryptoStreamMode.Write)

        ' Convert the data to a byte array.
        Dim original As String = "Here is some data to encrypt."
        Dim toEncrypt As Byte() = Encoding.ASCII.GetBytes(original)

        ' Write all data to the crypto stream and flush it.
        csEncrypt.Write(toEncrypt, 0, toEncrypt.Length)
        csEncrypt.FlushFinalBlock()

        ' Get the encrypted array of bytes.
        Dim encrypted As Byte() = msEncrypt.ToArray()

        '''''''''''''''''''''''''''''''''''''''''''''''''''''''
        ' This is where the data could be transmitted or saved.
        '''''''''''''''''''''''''''''''''''''''''''''''''''''''

        'Get a decryptor that uses the same key and IV as the encryptor.
        Dim decryptor As ICryptoTransform = rc2CSP.CreateDecryptor(key, IV)

        ' Now decrypt the previously encrypted message using the decryptor
        ' obtained in the above step.
        Dim msDecrypt As New MemoryStream(encrypted)
        Dim csDecrypt As New CryptoStream(msDecrypt, decryptor, CryptoStreamMode.Read)

        ' Read the decrypted bytes from the decrypting stream
        ' and place them in a StringBuilder class.
        Dim roundtrip As New StringBuilder()

        Dim b As Integer = 0

        Do
            b = csDecrypt.ReadByte()

            If b <> -1 Then
                roundtrip.Append(ChrW(b))
            End If
        Loop While b <> -1

        ' Display the original data and the decrypted data.
        Console.WriteLine("Original:   {0}", original)
        Console.WriteLine("Round Trip: {0}", roundtrip)

    End Sub
End Module

Comentários

A RC2CryptoServiceProvider implementação dá suporte a comprimentos de chave de 40 bits a 128 bits em incrementos de 8 bits.

O RC2CryptoServiceProvider objeto é uma criptografia de bloco que criptografa e descriptografa dados em blocos de 8 bytes. Essa classe bloqueará o bloco final de dados se for menor que 8 bytes. Como resultado desse preenchimento, o comprimento dos dados criptografados pode ser maior que o texto sem formatação original.

Observe que o RC2CryptoServiceProvider objeto não usa sal.

Observação

Um algoritmo de criptografia simétrica mais recente, AES (Advanced Encryption Standard), está disponível. Considere usar o Aes algoritmo e suas classes derivadas em vez da RC2CryptoServiceProvider classe. Use RC2CryptoServiceProvider apenas para compatibilidade com aplicativos e dados herdados.

Construtores

RC2CryptoServiceProvider()

Inicializa uma nova instância da classe RC2CryptoServiceProvider.

Campos

BlockSizeValue	Representa o tamanho do bloco, em bits, da operação criptográfica. (Herdado de SymmetricAlgorithm)
EffectiveKeySizeValue	Representa o tamanho efetivo da chave secreta usada pelo algoritmo RC2 em bits. (Herdado de RC2)
FeedbackSizeValue	Representa o tamanho dos comentários, em bits, da operação de criptografia. (Herdado de SymmetricAlgorithm)
IVValue	Representa o vetor de inicialização (IV) do algoritmo simétrico. (Herdado de SymmetricAlgorithm)
KeySizeValue	Representa o tamanho, em bits, da chave secreta usada pelo algoritmo simétrico. (Herdado de SymmetricAlgorithm)
KeyValue	Representa a chave secreta para o algoritmo simétrico. (Herdado de SymmetricAlgorithm)
LegalBlockSizesValue	Especifica os tamanhos de bloco, em bits, que têm suporte pelo algoritmo simétrico. (Herdado de SymmetricAlgorithm)
LegalKeySizesValue	Especifica os tamanhos de chave, em bits, que têm suporte pelo algoritmo simétrico. (Herdado de SymmetricAlgorithm)
ModeValue	Representa o modo de criptografia usado no algoritmo simétrico. (Herdado de SymmetricAlgorithm)
PaddingValue	Representa o modo de preenchimento usado no algoritmo simétrico. (Herdado de SymmetricAlgorithm)

Propriedades

BlockSize	Obtém ou define o tamanho do bloco, em bits, da operação de criptografia. (Herdado de SymmetricAlgorithm)
EffectiveKeySize	Obtém ou define o tamanho efetivo, em bits, da chave secreta usada pelo algoritmo RC2.
FeedbackSize	Obtém ou define o tamanho dos comentários, em bits, da operação de criptografia para os modos de codificação CFB (Comentário de Codificação) e OFB (Comentário de Saída). (Herdado de SymmetricAlgorithm)
IV	Obtém ou define o vetor de inicialização (IV) para o algoritmo simétrico. (Herdado de SymmetricAlgorithm)
Key	Obtém ou define a chave secreta para o algoritmo simétrico. (Herdado de SymmetricAlgorithm)
KeySize	Obtém ou define o tamanho da chave secreta usada pelo algoritmo RC2 em bits. (Herdado de RC2)
LegalBlockSizes	Obtém os tamanhos de bloco, em bits, que tem suporte com o algoritmo simétrico. (Herdado de SymmetricAlgorithm)
LegalKeySizes	Obtém os tamanhos de chave, em bits, que têm suporte pelo algoritmo simétrico. (Herdado de SymmetricAlgorithm)
Mode	Obtém ou define o modo de operação do algoritmo simétrico. (Herdado de SymmetricAlgorithm)
Padding	Obtém ou define o modo de preenchimento usado no algoritmo simétrico. (Herdado de SymmetricAlgorithm)
UseSalt	Obtém ou define um valor que determina se é necessário criar uma chave com um sal de valor zero com 11 bytes de extensão.

Métodos

Clear()	Libera todos os recursos usados pela classe SymmetricAlgorithm. (Herdado de SymmetricAlgorithm)
CreateDecryptor()	Cria um objeto descriptografador simétrico com a propriedade Key atual e o vetor de inicialização (IV). (Herdado de SymmetricAlgorithm)
CreateDecryptor(Byte[], Byte[])	Cria um objeto descriptografador RC2 simétrico usando a chave especificada (Key) e o vetor de inicialização (IV).
CreateEncryptor()	Cria um objeto criptografador simétrico com a propriedade Key atual e o vetor de inicialização (IV). (Herdado de SymmetricAlgorithm)
CreateEncryptor(Byte[], Byte[])	Cria um objeto criptografador RC2 simétrico com a chave Key atual e o vetor de inicialização (IV).
DecryptCbc(Byte[], Byte[], PaddingMode)	Descriptografa os dados usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Descriptografa os dados usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
DecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Descriptografa os dados no buffer especificado, usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
DecryptCfb(Byte[], Byte[], PaddingMode, Int32)	Descriptografa os dados usando o modo CFB com o modo de preenchimento especificado e o tamanho do comentário. (Herdado de SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	Descriptografa os dados usando o modo CFB com o modo de preenchimento especificado e o tamanho do comentário. (Herdado de SymmetricAlgorithm)
DecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Descriptografa os dados no buffer especificado, usando o modo CFB com o modo de preenchimento especificado e o tamanho do comentário. (Herdado de SymmetricAlgorithm)
DecryptEcb(Byte[], PaddingMode)	Descriptografa os dados usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Descriptografa os dados usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
DecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Descriptografa os dados no buffer especificado, usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
Dispose()	Libera todos os recursos usados pela instância atual da classe SymmetricAlgorithm. (Herdado de SymmetricAlgorithm)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo SymmetricAlgorithm e opcionalmente libera os recursos gerenciados. (Herdado de SymmetricAlgorithm)
EncryptCbc(Byte[], Byte[], PaddingMode)	Criptografa dados usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode)	Criptografa dados usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
EncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Criptografa dados no buffer especificado, usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
EncryptCfb(Byte[], Byte[], PaddingMode, Int32)	Criptografa dados usando o modo CFB com o modo de preenchimento especificado e o tamanho do comentário. (Herdado de SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, PaddingMode, Int32)	Criptografa dados usando o modo CFB com o modo de preenchimento especificado e o tamanho do comentário. (Herdado de SymmetricAlgorithm)
EncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Criptografa dados no buffer especificado, usando o modo CFB com o modo de preenchimento especificado e o tamanho do comentário. (Herdado de SymmetricAlgorithm)
EncryptEcb(Byte[], PaddingMode)	Criptografa dados usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, PaddingMode)	Criptografa dados usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
EncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode)	Criptografa dados no buffer especificado, usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GenerateIV()	Gera um vetor de inicialização aleatório (IV) a ser usado para o algoritmo.
GenerateKey()	Gera uma chave aleatória (Key) a ser usadas para o algoritmo.
GetCiphertextLengthCbc(Int32, PaddingMode)	Obtém o comprimento de um texto cifrado com um determinado modo de preenchimento e comprimento de texto não criptografado no modo CBC. (Herdado de SymmetricAlgorithm)
GetCiphertextLengthCfb(Int32, PaddingMode, Int32)	Obtém o comprimento de um texto cifrado com um determinado modo de preenchimento e comprimento de texto não criptografado no modo CFB. (Herdado de SymmetricAlgorithm)
GetCiphertextLengthEcb(Int32, PaddingMode)	Obtém o comprimento de um texto cifrado com um determinado modo de preenchimento e comprimento de texto não criptografado no modo ECB. (Herdado de SymmetricAlgorithm)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TryDecryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)	Tenta descriptografar dados no buffer especificado, usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
TryDecryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando substituído em uma classe derivada, tenta descriptografar dados no buffer especificado, usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
TryDecryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Tenta descriptografar dados no buffer especificado, usando o modo CFB com o modo de preenchimento especificado e o tamanho do comentário. (Herdado de SymmetricAlgorithm)
TryDecryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Quando substituído em uma classe derivada, tenta descriptografar dados no buffer especificado, usando o modo CFB com o modo de preenchimento e o tamanho dos comentários especificados. (Herdado de SymmetricAlgorithm)
TryDecryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Tenta descriptografar dados no buffer especificado, usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
TryDecryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando substituído em uma classe derivada, tenta descriptografar dados no buffer especificado, usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
TryEncryptCbc(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode)	Tenta criptografar dados no buffer especificado, usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
TryEncryptCbcCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando substituído em uma classe derivada, tenta criptografar dados no buffer especificado, usando o modo CBC com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
TryEncryptCfb(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, PaddingMode, Int32)	Tenta criptografar dados no buffer especificado, usando o modo CFB com o modo de preenchimento e o tamanho de comentários especificados. (Herdado de SymmetricAlgorithm)
TryEncryptCfbCore(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32, Int32)	Quando substituído em uma classe derivada, tenta criptografar dados no buffer especificado, usando o modo CFB com o modo de preenchimento e o tamanho dos comentários especificados. (Herdado de SymmetricAlgorithm)
TryEncryptEcb(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Tenta criptografar dados no buffer especificado, usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
TryEncryptEcbCore(ReadOnlySpan<Byte>, Span<Byte>, PaddingMode, Int32)	Quando substituído em uma classe derivada, tenta criptografar dados no buffer especificado, usando o modo ECB com o modo de preenchimento especificado. (Herdado de SymmetricAlgorithm)
ValidKeySize(Int32)	Determina se o tamanho da chave especificado é válido para o algoritmo atual. (Herdado de SymmetricAlgorithm)

Implantações explícitas de interface

IDisposable.Dispose()

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Libera os recursos não gerenciados usados pelo SymmetricAlgorithm e opcionalmente libera os recursos gerenciados.

(Herdado de SymmetricAlgorithm)

Aplica-se a

Confira também

Serviços criptográficos