ProtectedData.Protect Metoda

Definice

Obor názvů:: System.Security.Cryptography

Sestavení:: System.Security.Cryptography.ProtectedData.dll

Sestavení:: System.Security.dll

Balíček:: System.Security.Cryptography.ProtectedData v11.0.0-preview.5.26302.115

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zašifruje data v zadané vyrovnávací paměti a zapíše zašifrovaná data do cílové vyrovnávací paměti.

Přetížení

Name	Description
Protect(Byte[], Byte[], DataProtectionScope)	Zašifruje data v zadaném bajtovém poli a vrátí bajtovou matici, která obsahuje šifrovaná data.
Protect(ReadOnlySpan<Byte>, DataProtectionScope, ReadOnlySpan<Byte>)	Zašifruje data v zadaném bajtovém rozsahu a vrátí pole bajtů, které obsahuje šifrovaná data.
Protect(ReadOnlySpan<Byte>, DataProtectionScope, Span<Byte>, ReadOnlySpan<Byte>)	Zašifruje data v zadané vyrovnávací paměti a zapíše zašifrovaná data do cílové vyrovnávací paměti.

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

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zašifruje data v zadaném bajtovém poli a vrátí bajtovou matici, která obsahuje šifrovaná data.

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()

Parametry

userData: Byte[]

Bajtové pole, které obsahuje data k šifrování.

optionalEntropy: Byte[]

Volitelné další bajtové pole, které se používá ke zvýšení složitosti šifrování nebo null bez další složitosti.

scope: DataProtectionScope

Jedna z hodnot výčtu, která určuje rozsah šifrování.

Návraty

Byte[]

Bajtové pole představující šifrovaná data.

Výjimky

ArgumentNullException

Parametr userData je null.

CryptographicException

Šifrování se nezdařilo.

NotSupportedException

Operační systém tuto metodu nepodporuje.

OutOfMemoryException

Systém při šifrování dat vyčerpal paměť.

PlatformNotSupportedException

pouze .NET Core a .NET 5 nebo novější: Volání metody Protect jsou podporována pouze v operačních systémech Windows.

Příklady

Následující příklad ukazuje, jak používat ochranu dat.

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

Poznámky

Tuto metodu lze použít k šifrování dat, jako jsou hesla, klíče nebo připojovací řetězce. Tento optionalEntropy parametr umožňuje přidávat data, aby se zvýšila složitost šifrování. Určete null , že není nutné provádět žádné další složitosti. Pokud jsou k dispozici, musí být tyto informace použity také při dešifrování dat pomocí Unprotect metody.

Note

Pokud tuto metodu používáte během zosobnění, může se zobrazit následující chyba: Klíč není platný pro použití v zadaném stavu. Chcete-li této chybě zabránit, načtěte profil uživatele, kterého chcete zosobnit před voláním metody.

Platí pro

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

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zašifruje data v zadaném bajtovém rozsahu a vrátí pole bajtů, které obsahuje šifrovaná data.

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()

Parametry

userData: ReadOnlySpan<Byte>

Vyrovnávací paměť, která obsahuje data k šifrování.

scope: DataProtectionScope

Jedna z hodnot výčtu, která určuje rozsah šifrování.

optionalEntropy: ReadOnlySpan<Byte>

Volitelné další bajtové rozpětí, které se používá ke zvýšení složitosti šifrování nebo prázdné kvůli žádné další složitosti.

Návraty

Byte[]

Bajtové pole představující šifrovaná data.

Výjimky

CryptographicException

Šifrování se nezdařilo.

NotSupportedException

Operační systém tuto metodu nepodporuje.

OutOfMemoryException

Systém při šifrování dat vyčerpal paměť.

PlatformNotSupportedException

Operační systém není Windows.

Platí pro

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

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zdroj:: ProtectedData.cs

Zašifruje data v zadané vyrovnávací paměti a zapíše zašifrovaná data do cílové vyrovnávací paměti.

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

Parametry

userData: ReadOnlySpan<Byte>

Vyrovnávací paměť, která obsahuje data k šifrování.

scope: DataProtectionScope

Jedna z hodnot výčtu, která určuje rozsah šifrování.

destination: Span<Byte>

Vyrovnávací paměť pro příjem šifrovaných dat.

optionalEntropy: ReadOnlySpan<Byte>

Volitelná dodatečná vyrovnávací paměť, která se používá ke zvýšení složitosti šifrování, nebo prázdná kvůli žádné další složitosti.

Návraty

Int32

Celkový počet bajtů zapsaných do destination

Výjimky

ArgumentException

Vyrovnávací paměť destination je příliš malá pro uložení šifrovaných dat.

CryptographicException

Šifrování se nezdařilo.

NotSupportedException

Operační systém tuto metodu nepodporuje.

OutOfMemoryException

Systém při šifrování dat vyčerpal paměť.

PlatformNotSupportedException

Operační systém není Windows.

Platí pro

Váš názor

Byla tato stránka užitečná?