ProtectedData.Protect Método

Definição

Espaço de Nomes:: System.Security.Cryptography

Assemblagem:: System.Security.Cryptography.ProtectedData.dll

Assemblagem:: System.Security.dll

Pacote:: System.Security.Cryptography.ProtectedData v11.0.0-preview.5.26302.115

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Encripta os dados num buffer especificado e escreve os dados encriptados num buffer de destino.

Sobrecargas

Name	Descrição
Protect(Byte[], Byte[], DataProtectionScope)	Encripta os dados num array de bytes especificado e devolve um array de bytes que contém os dados encriptados.
Protect(ReadOnlySpan<Byte>, DataProtectionScope, ReadOnlySpan<Byte>)	Encripta os dados num intervalo de bytes especificado e devolve um array de bytes que contém os dados encriptados.
Protect(ReadOnlySpan<Byte>, DataProtectionScope, Span<Byte>, ReadOnlySpan<Byte>)	Encripta os dados num buffer especificado e escreve os dados encriptados num buffer de destino.

Protect(Byte[], Byte[], DataProtectionScope)

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Encripta os dados num array de bytes especificado e devolve um array de bytes que contém os dados encriptados.

public:
 static cli::array <System::Byte> ^ Protect(cli::array <System::Byte> ^ userData, cli::array <System::Byte> ^ optionalEntropy, System::Security::Cryptography::DataProtectionScope scope);

public static byte[] Protect(byte[] userData, byte[]? optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);

public static byte[] Protect(byte[] userData, byte[] optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);

static member Protect : byte[] * byte[] * System.Security.Cryptography.DataProtectionScope -> byte[]

Public Shared Function Protect (userData As Byte(), optionalEntropy As Byte(), scope As DataProtectionScope) As Byte()

Parâmetros

userData: Byte[]

Um array de bytes que contém dados para encriptar.

optionalEntropy: Byte[]

Um array opcional de bytes adicionais usado para aumentar a complexidade da encriptação, ou null sem complexidade adicional.

scope: DataProtectionScope

Um dos valores de enumeração que especifica o âmbito da encriptação.

Devoluções

Byte[]

Um array de bytes que representa os dados encriptados.

Exceções

ArgumentNullException

O userData parâmetro é null.

CryptographicException

A encriptação falhou.

NotSupportedException

O sistema operativo não suporta este método.

OutOfMemoryException

O sistema ficou sem memória durante a encriptação dos dados.

PlatformNotSupportedException

.NET Core e .NET 5+ apenas: Chamadas ao método Protect são suportadas apenas em sistemas operativos Windows.

Exemplos

O exemplo seguinte mostra como usar a proteção de dados.

using System;
using System.Security.Cryptography;

public class DataProtectionSample
{
    // Create byte array for additional entropy when using Protect method.
    static byte [] s_additionalEntropy = { 9, 8, 7, 6, 5 };

    public static void Main()
    {
        // Create a simple byte array containing data to be encrypted.
        byte [] secret = { 0, 1, 2, 3, 4, 1, 2, 3, 4 };

        //Encrypt the data.
        byte [] encryptedSecret = Protect( secret );
        Console.WriteLine("The encrypted byte array is:");
        PrintValues(encryptedSecret);

        // Decrypt the data and store in a byte array.
        byte [] originalData = Unprotect( encryptedSecret );
        Console.WriteLine("{0}The original data is:", Environment.NewLine);
        PrintValues(originalData);
    }

    public static byte [] Protect( byte [] data )
    {
        try
        {
            // Encrypt the data using DataProtectionScope.CurrentUser. The result can be decrypted
            // only by the same current user.
            return ProtectedData.Protect( data, s_additionalEntropy, DataProtectionScope.CurrentUser );
        }
        catch (CryptographicException e)
        {
            Console.WriteLine("Data was not encrypted. An error occurred.");
            Console.WriteLine(e.ToString());
            return null;
        }
    }

    public static byte [] Unprotect( byte [] data )
    {
        try
        {
            //Decrypt the data using DataProtectionScope.CurrentUser.
            return ProtectedData.Unprotect( data, s_additionalEntropy, DataProtectionScope.CurrentUser );
        }
        catch (CryptographicException e)
        {
            Console.WriteLine("Data was not decrypted. An error occurred.");
            Console.WriteLine(e.ToString());
            return null;
        }
    }

    public static void PrintValues( Byte[] myArr )
    {
        foreach ( Byte i in myArr )
        {
            Console.Write( "\t{0}", i );
        }
        Console.WriteLine();
    }
}

Imports System.Security.Cryptography



Public Class DataProtectionSample
    ' Create byte array for additional entropy when using Protect method.
    Private Shared s_additionalEntropy As Byte() = {9, 8, 7, 6, 5}


    Public Shared Sub Main()
        ' Create a simple byte array containing data to be encrypted.
        Dim secret As Byte() = {0, 1, 2, 3, 4, 1, 2, 3, 4}

        'Encrypt the data.
        Dim encryptedSecret As Byte() = Protect(secret)
        Console.WriteLine("The encrypted byte array is:")
        PrintValues(encryptedSecret)

        ' Decrypt the data and store in a byte array.
        Dim originalData As Byte() = Unprotect(encryptedSecret)
        Console.WriteLine("{0}The original data is:", Environment.NewLine)
        PrintValues(originalData)

    End Sub


    Public Shared Function Protect(ByVal data() As Byte) As Byte()
        Try
            ' Encrypt the data using DataProtectionScope.CurrentUser. The result can be decrypted
            '  only by the same current user.
            Return ProtectedData.Protect(data, s_additionalEntropy, DataProtectionScope.CurrentUser)
        Catch e As CryptographicException
            Console.WriteLine("Data was not encrypted. An error occurred.")
            Console.WriteLine(e.ToString())
            Return Nothing
        End Try

    End Function


    Public Shared Function Unprotect(ByVal data() As Byte) As Byte()
        Try
            'Decrypt the data using DataProtectionScope.CurrentUser.
            Return ProtectedData.Unprotect(data, s_additionalEntropy, DataProtectionScope.CurrentUser)
        Catch e As CryptographicException
            Console.WriteLine("Data was not decrypted. An error occurred.")
            Console.WriteLine(e.ToString())
            Return Nothing
        End Try

    End Function


    Public Shared Sub PrintValues(ByVal myArr() As [Byte])
        Dim i As [Byte]
        For Each i In myArr
            Console.Write(vbTab + "{0}", i)
        Next i
        Console.WriteLine()

    End Sub
End Class

Observações

Este método pode ser usado para encriptar dados como palavras-passe, chaves ou strings de ligação. O optionalEntropy parâmetro permite-lhe adicionar dados para aumentar a complexidade da encriptação; especifique null sem complexidade adicional. Se fornecida, esta informação deve também ser usada ao desencriptar os dados usando o Unprotect método.

Note

Se usar este método durante a personificação, pode receber o seguinte erro: "Chave não válida para uso no estado especificado." Para evitar este erro, carregue o perfil do utilizador que pretende imitar antes de chamar o método.

Aplica-se a

Protect(ReadOnlySpan<Byte>, DataProtectionScope, ReadOnlySpan<Byte>)

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Encripta os dados num intervalo de bytes especificado e devolve um array de bytes que contém os dados encriptados.

public static byte[] Protect(ReadOnlySpan<byte> userData, System.Security.Cryptography.DataProtectionScope scope, ReadOnlySpan<byte> optionalEntropy = default);

static member Protect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * ReadOnlySpan<byte> -> byte[]

Public Shared Function Protect (userData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Byte()

Parâmetros

userData: ReadOnlySpan<Byte>

Um buffer que contém os dados a encriptar.

scope: DataProtectionScope

Um dos valores de enumeração que especifica o âmbito da encriptação.

optionalEntropy: ReadOnlySpan<Byte>

Um espaço opcional de bytes adicionais usado para aumentar a complexidade da encriptação, ou vazio sem complexidade adicional.

Devoluções

Byte[]

Um array de bytes que representa os dados encriptados.

Exceções

CryptographicException

A encriptação falhou.

NotSupportedException

O sistema operativo não suporta este método.

OutOfMemoryException

O sistema ficou sem memória durante a encriptação dos dados.

PlatformNotSupportedException

O sistema operativo não é o Windows.

Aplica-se a

Protect(ReadOnlySpan<Byte>, DataProtectionScope, Span<Byte>, ReadOnlySpan<Byte>)

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Encripta os dados num buffer especificado e escreve os dados encriptados num buffer de destino.

public static int Protect(ReadOnlySpan<byte> userData, System.Security.Cryptography.DataProtectionScope scope, Span<byte> destination, ReadOnlySpan<byte> optionalEntropy = default);

static member Protect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * Span<byte> * ReadOnlySpan<byte> -> int

Public Shared Function Protect (userData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, destination As Span(Of Byte), Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Integer

Parâmetros

userData: ReadOnlySpan<Byte>

Um buffer que contém dados para encriptar.

scope: DataProtectionScope

Um dos valores de enumeração que especifica o âmbito da encriptação.

destination: Span<Byte>

O buffer para receber os dados encriptados.

optionalEntropy: ReadOnlySpan<Byte>

Um buffer adicional opcional usado para aumentar a complexidade da encriptação, ou vazio sem complexidade adicional.

Devoluções

Int32

O número total de bytes escritos em destination

Exceções

ArgumentException

O buffer é destination demasiado pequeno para armazenar os dados encriptados.

CryptographicException

A encriptação falhou.

NotSupportedException

O sistema operativo não suporta este método.

OutOfMemoryException

O sistema ficou sem memória durante a encriptação dos dados.

PlatformNotSupportedException

O sistema operativo não é o Windows.

Aplica-se a

Comentários

Esta página foi útil?