MachineKeySection.ValidationKey Eigenschaft

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

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 trueenableViewStateMAC ein Nachrichtenauthentifizierungscode (Message Authentication Code, 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 Sitzungszustandsvariablen 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 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 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.