MachineKeySection.ValidationKey Eigenschaft

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Ruft den Schlüssel ab, mit dem Formularauthentifizierungs- und Ansichtszustandsdaten validiert werden, oder den Prozess, durch den der Schlüssel generiert wird, oder legt den Schlüssel bzw. den Prozess fest.

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

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

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

Public Property ValidationKey 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 gezeigt, wie die ValidationKey Eigenschaft mithilfe von Code festgelegt wird. Dieses Beispiel ist Teil eines größeren Beispiels, das für die MachineKeySection -Klasse bereitgestellt wird.

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

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

Hinweise

Die ValidationKey -Eigenschaft wird verwendet, wenn enableViewStateMAC ein Nachrichtenauthentifizierungscode (MAC) erstellt wird true , um ASP.NET zu aktivieren, um festzustellen, ob der Ansichtszustand manipuliert wurde. Die ValidationKey -Eigenschaft wird auch verwendet, um anwendungsspezifische Sitzungs-IDs für out-of-process zu generieren, um sicherzustellen, dass Sitzungszustandsvariablen zwischen Anwendungen isoliert werden.

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 dem Wert "AutoGenerate" den Modifizierer "IsolateApps" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung, indem Sie den - AppDomainAppVirtualPathWert jeder Anwendung verwenden. Dies ist die Standardeinstellung.

Wenn Sie dem Wert "AutoGenerate" den Modifizierer "IsolateByAppId" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung, indem Sie den - AppDomainAppIdWert jeder Anwendung verwenden. Wenn zwei unterschiedliche Anwendungen einen virtuellen Pfad gemeinsam nutzen (möglicherweise, weil diese Anwendungen an verschiedenen Ports ausgeführt werden), kann dieses Flag verwendet werden, um sie weiter voneinander zu unterscheiden. Das Flag "IsolateByAppId" wird nur von ASP.NET 4.5 verstanden, kann aber 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 ValidationKey Eigenschaft manuell fest, um eine konsistente Konfiguration sicherzustellen. Informationen zum manuellen Generieren von Werten für das DecryptionKey Attribut finden Sie unter Vorgehensweise: Konfigurieren von MachineKey in ASP.NET 2.0.

Diese Eigenschaft wird in der validationKey Regel deklarativ im Attribut des machineKey-Elements der Web.config-Datei festgelegt.