DataProtectionScope 列舉

定義

命名空間:

System.Security.Cryptography

組件:

System.Security.Cryptography.ProtectedData.dll

來源:

DataProtectionScope.cs

設定 Protect(Byte[], Byte[], DataProtectionScope) 方法要套用的資料保護範圍。

public enum DataProtectionScope

繼承

Object

ValueType

Enum

DataProtectionScope

欄位

名稱	值	Description
CurrentUser	0	受保護的資料與目前的使用者有關聯。 只有在目前使用者內容中執行的執行緒，才能夠解除資料的保護。
LocalMachine	1	受保護的資料與機器的內容有關聯。 這台電腦上執行的任何處理序都能夠解除資料的保護。 這個列舉值通常是在伺服器上執行的伺服器特定應用程式中使用，這種狀況不允許不受信任的使用者存取資料。

範例

下列程式代碼範例示範如何使用數據保護。

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

備註

此列舉會與 和 Unprotect 方法搭配使用，Protect以透過加密保護數據。

謹慎 LocalMachine 列舉值允許多個帳戶解除保護數據。 只有在您信任計算機上的每一個帳戶時，才使用此值。 在大部分情況下，您應該使用 CurrentUser 值。