MachineKeySection.DecryptionKey Eigenschaft

Referenz

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Schlüssel ab, mit dem Daten verschlüsselt und entschlüsselt werden, oder den Prozess, durch den der Schlüssel generiert wird, oder legt den Schlüssel bzw. den Prozess fest.

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

Eigenschaftswert

String

Ein Schlüsselwert oder ein Wert, der angibt, wie der Schlüssel generiert wird. Der Standardwert ist "AutoGenerate,IsolateApps".

Attribute: TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die DecryptionKey Eigenschaft mithilfe von Code festlegen. In diesem Beispiel wird ein größeres Beispiel für die MachineKeySection Klasse bereitgestellt.

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

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

Hinweise

Die DecryptionKey Eigenschaft wird zur Verschlüsselung und Entschlüsselung verwendet, z. B. in Windows Forms Authentifizierung und zum Ansichtszustand, wenn die Validation Eigenschaft auf "3DES" oder "AES" festgelegt ist.

Verwenden Sie die Option "AutoGenerate", um anzugeben, dass ASP.NET einen zufälligen Schlüssel generiert und in der lokalen Sicherheitsbehörde gespeichert wird. Die Option "AutoGenerate" ist Teil des Standardwerts.

Wenn Sie dem Wert "AutoGenerate" den Modifizierer "IsolateApps" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung mithilfe der einzelnen AnwendungenAppDomainAppVirtualPath. Dies ist die Standardeinstellung.

Wenn Sie dem Wert "IsolateByAppId" den Wert "AutoGenerate" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung mithilfe der einzelnen AnwendungenAppDomainAppId. Wenn zwei unterschiedliche Anwendungen einen virtuellen Pfad teilen (vielleicht weil diese Anwendungen auf verschiedenen Ports ausgeführt werden), kann diese Kennzeichnung verwendet werden, um sie weiter von einem anderen zu unterscheiden. Das Flag "IsolateByAppId" wird nur von ASP.NET 4.5 verstanden, kann jedoch unabhängig von der MachineKeySection.CompatibilityMode Einstellung verwendet werden.

Wenn Sie die Konfiguration in einem Netzwerk von Webservern (einer Webfarm) unterstützen müssen, legen Sie die DecryptionKey Eigenschaft manuell fest, um eine konsistente Konfiguration sicherzustellen. Informationen zum manuellen Generieren von Werten für das DecryptionKey Attribut finden Sie unter How To: Configure MachineKey in ASP.NET 2.0.

Diese Eigenschaft wird in der DecryptionKey Regel deklarativ im Attribut des machineKey-Elements der Web.config-Datei festgelegt. Weitere Informationen finden Sie im MachineKey-Element .

Gilt für

Siehe auch

MachineKeySection