MachineKeySection.DecryptionKey Właściwość

Definicja

Przestrzeń nazw:

System.Web.Configuration

Zestaw:

System.Web.dll

Pobiera lub ustawia klucz używany do szyfrowania i odszyfrowywania danych lub procesu, za pomocą którego jest generowany klucz.

public:
 property System::String ^ DecryptionKey { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))]
[System.Configuration.ConfigurationProperty("decryptionKey", DefaultValue="AutoGenerate,IsolateApps")]
[System.Configuration.StringValidator(MinLength=1)]
public string DecryptionKey { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))>]
[<System.Configuration.ConfigurationProperty("decryptionKey", DefaultValue="AutoGenerate,IsolateApps")>]
[<System.Configuration.StringValidator(MinLength=1)>]
member this.DecryptionKey : string with get, set

Public Property DecryptionKey As String

Wartość właściwości

String

Wartość klucza lub wartość wskazująca sposób generowania klucza. Wartość domyślna to "AutoGenerate,IsolateApps".

Atrybuty

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Przykłady

W poniższym przykładzie pokazano, jak ustawić DecryptionKey właściwość przy użyciu kodu. Ten przykład jest częścią większego przykładu udostępnionego MachineKeySection dla klasy.

// Display DecryptionKey property.
Console.WriteLine("DecryptionKey: {0}",
  configSection.DecryptionKey);

' Display DecryptionKey property.
Console.WriteLine("DecryptionKey: {0}", configSection.DecryptionKey)

Uwagi

Właściwość DecryptionKey jest używana do szyfrowania i odszyfrowywania, na przykład w przypadku uwierzytelniania formularzy systemu Windows, oraz do wyświetlania stanu, gdy Validation właściwość jest ustawiona na wartość "3DES" lub "AES".

Użyj opcji "Autogeneruj", aby określić, że ASP.NET generuje losowy klucz i przechowuje go w lokalnym urzędzie zabezpieczeń. Opcja "AutoGeneruj" jest częścią wartości domyślnej.

Jeśli dodasz modyfikator "IsolateApps" do wartości "AutoGenerate" ValidationKey , ASP.NET generuje unikatowy zaszyfrowany klucz dla każdej aplikacji przy użyciu każdej aplikacji AppDomainAppVirtualPath. Jest to ustawienie domyślne.

Jeśli dodasz modyfikator "IsolateByAppId" do wartości "AutoGenerate" ValidationKey , ASP.NET generuje unikatowy zaszyfrowany klucz dla każdej aplikacji przy użyciu każdej aplikacji AppDomainAppId. Jeśli dwie odrębne aplikacje współużytkują ścieżkę wirtualną (być może dlatego, że te aplikacje działają na różnych portach), ta flaga może służyć do dalszego odróżnienia ich od siebie. Flaga "IsolateByAppId" jest zrozumiała tylko przez ASP.NET 4.5, ale może być używana niezależnie od MachineKeySection.CompatibilityMode ustawienia.

Jeśli musisz obsługiwać konfigurację w sieci serwerów sieci Web (farmy sieci Web), ustaw DecryptionKey właściwość ręcznie, aby zapewnić spójną konfigurację. Aby uzyskać informacje na temat ręcznego generowania wartości atrybutu DecryptionKey , zobacz How To: Configure MachineKey in ASP.NET 2.0 (Instrukcje: konfigurowanie klucza maszynowego w ASP.NET 2.0).

Ta właściwość jest zwykle ustawiana deklaratywnie w DecryptionKey atrybucie elementu machineKey pliku Web.config. Aby uzyskać więcej informacji, zobacz element machineKey .

Zobacz też

• MachineKeySection