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

Das folgende Beispiel zeigt, wie Sie die ValidationKey Eigenschaft mithilfe von Code festlegen. 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 true enableViewStateMAC ein Nachrichtenauthentifizierungscode (MAC) erstellt wird, um ASP.NET zu aktivieren, um zu bestimmen, ob der Ansichtszustand manipuliert wurde. Die ValidationKey Eigenschaft wird auch verwendet, um anwendungsspezifische Sitzungs-IDs zu generieren, um sicherzustellen, dass Sitzungsstatusvariablen zwischen Anwendungen isoliert sind.

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 einzelnen AnwendungenAppDomainAppVirtualPath. 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 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 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) 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 How To: Configure MachineKey in ASP.NET 2.0.

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