Język

ProtectedData.Unprotect Metoda

Definicja

Odszyfrowuje dane w określonym buforze i zapisuje odszyfrowane dane do buforu docelowego.

Przeciążenia

Nazwa Opis
Unprotect(Byte[], Byte[], DataProtectionScope)

Odszyfrowuje dane w określonej tablicy bajtów i zwraca tablicę bajtów zawierającą odszyfrowane dane.

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

Odszyfrowuje dane w określonej tablicy bajtów i zwraca tablicę bajtów zawierającą odszyfrowane dane.

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

Odszyfrowuje dane w określonym buforze i zapisuje odszyfrowane dane do buforu docelowego.

Unprotect(Byte[], Byte[], DataProtectionScope)

Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs

Odszyfrowuje dane w określonej tablicy bajtów i zwraca tablicę bajtów zawierającą odszyfrowane dane.

public:
 static cli::array <System::Byte> ^ Unprotect(cli::array <System::Byte> ^ encryptedData, cli::array <System::Byte> ^ optionalEntropy, System::Security::Cryptography::DataProtectionScope scope);
public static byte[] Unprotect(byte[] encryptedData, byte[]? optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);
public static byte[] Unprotect(byte[] encryptedData, byte[] optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);
static member Unprotect : byte[] * byte[] * System.Security.Cryptography.DataProtectionScope -> byte[]
Public Shared Function Unprotect (encryptedData As Byte(), optionalEntropy As Byte(), scope As DataProtectionScope) As Byte()

Parametry

encryptedData
Byte[]

Tablica bajtów zawierająca dane zaszyfrowane przy użyciu Protect(Byte[], Byte[], DataProtectionScope) metody .

optionalEntropy
Byte[]

Opcjonalna dodatkowa tablica bajtów, która została użyta do szyfrowania danych lub null jeśli dodatkowa tablica bajtów nie została użyta.

scope
DataProtectionScope

Jedna z wartości wyliczenia określająca zakres ochrony danych używany do szyfrowania danych.

Zwraca

Byte[]

Tablica bajtów reprezentująca odszyfrowane dane.

Wyjątki

Parametr encryptedData jest null.

Odszyfrowywanie nie powiodło się.

System operacyjny nie obsługuje tej metody.

Brak pamięci.

tylko .NET Core i .NET 5+: wywołania metody Unprotect są obsługiwane tylko w systemach operacyjnych Windows.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ochrony danych.

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

Uwagi

Tej metody można użyć do usunięcia ochrony danych, które zostały zaszyfrowane przy użyciu Protect metody . optionalEntropy Jeśli parametr został użyty podczas szyfrowania, należy go podać, aby odszyfrować dane.

Note

Jeśli używasz tej metody podczas personifikacji, może zostać wyświetlony następujący błąd: "Klucz jest nieprawidłowy do użycia w określonym stanie". Aby zapobiec temu błędowi, załaduj profil użytkownika, którego chcesz personifikować przed wywołaniem metody.

Dotyczy

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

Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs

Odszyfrowuje dane w określonej tablicy bajtów i zwraca tablicę bajtów zawierającą odszyfrowane dane.

public static byte[] Unprotect(ReadOnlySpan<byte> encryptedData, System.Security.Cryptography.DataProtectionScope scope, ReadOnlySpan<byte> optionalEntropy = default);
static member Unprotect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * ReadOnlySpan<byte> -> byte[]
Public Shared Function Unprotect (encryptedData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Byte()

Parametry

encryptedData
ReadOnlySpan<Byte>

Bufor zawierający dane do odszyfrowywania.

scope
DataProtectionScope

Jedna z wartości wyliczenia, która określa zakres szyfrowania.

optionalEntropy
ReadOnlySpan<Byte>

Opcjonalny dodatkowy bufor służący do zwiększania złożoności szyfrowania lub pusty bez dodatkowej złożoności.

Zwraca

Byte[]

Tablica bajtów reprezentująca zaszyfrowane dane.

Wyjątki

Szyfrowanie nie powiodło się.

System operacyjny nie obsługuje tej metody.

System zabrakło pamięci podczas odszyfrowywania danych.

System operacyjny nie jest Windows.

Dotyczy

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

Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs
Źródło:
ProtectedData.cs

Odszyfrowuje dane w określonym buforze i zapisuje odszyfrowane dane do buforu docelowego.

public static int Unprotect(ReadOnlySpan<byte> encryptedData, System.Security.Cryptography.DataProtectionScope scope, Span<byte> destination, ReadOnlySpan<byte> optionalEntropy = default);
static member Unprotect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * Span<byte> * ReadOnlySpan<byte> -> int
Public Shared Function Unprotect (encryptedData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, destination As Span(Of Byte), Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Integer

Parametry

encryptedData
ReadOnlySpan<Byte>

Bufor zawierający dane do odszyfrowywania.

scope
DataProtectionScope

Jedna z wartości wyliczenia, która określa zakres szyfrowania.

destination
Span<Byte>

Bufor do odbierania odszyfrowanych danych.

optionalEntropy
ReadOnlySpan<Byte>

Opcjonalny dodatkowy bufor służący do zwiększania złożoności szyfrowania lub pusty bez dodatkowej złożoności.

Zwraca

Całkowita liczba bajtów zapisanych w destination

Wyjątki

Bufor w pliku destination jest za mały, aby przechowywać odszyfrowane dane.

Szyfrowanie nie powiodło się.

System operacyjny nie obsługuje tej metody.

System zabrakło pamięci podczas szyfrowania danych.

System operacyjny nie jest Windows.

Dotyczy