MachineKeySection.DecryptionKey Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen des Schlüssels, der zum Verschlüsseln und Entschlüsseln von Daten verwendet wird, oder den Prozess, mit dem der Schlüssel generiert wird.
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, setPublic Property DecryptionKey As StringEigenschaftswert
Ein Schlüsselwert oder ein Wert, der angibt, wie der Schlüssel generiert wird. Der Standardwert ist "AutoGenerate,IsolateApps".
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die DecryptionKey Eigenschaft mithilfe von Code festgelegt wird. Dieses Beispiel ist Teil eines größeren Beispiels, das für die MachineKeySection Klasse bereitgestellt wird.
// Display DecryptionKey property.
Console.WriteLine("DecryptionKey: {0}",
configSection.DecryptionKey);
' Display DecryptionKey property.
Console.WriteLine("DecryptionKey: {0}", configSection.DecryptionKey)
Hinweise
Die DecryptionKey Eigenschaft wird für die Verschlüsselung und Entschlüsselung verwendet, z. B. in der Windows Forms-Authentifizierung und für den 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 speichert. Die Option "AutoGenerate" ist Teil des Standardwerts.
Wenn Sie den Modifizierer "IsolateApps" zum Wert "AutoGenerate" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung mithilfe der AppDomainAppVirtualPatheinzelnen Anwendungen. Dies ist die Standardeinstellung.
Wenn Sie den Modifizierer "IsolateByAppId" zum Wert "AutoGenerate" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung mithilfe der AppDomainAppIdeinzelnen Anwendungen. Wenn zwei unterschiedliche Anwendungen einen virtuellen Pfad gemeinsam nutzen (z. B. weil diese Anwendungen auf unterschiedlichen Ports ausgeführt werden), kann dieses Kennzeichen verwendet werden, um sie voneinander weiter 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 über ein Netzwerk von Webservern (eine Webfarm) hinweg 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 datei Web.config festgelegt. Weitere Informationen finden Sie im machineKey-Element .
