MachineKeySection.ValidationKey Właściwość

Definicja

Przestrzeń nazw:

System.Web.Configuration

Zestaw:

System.Web.dll

Pobiera lub ustawia klucz używany do weryfikowania uwierzytelniania formularzy i wyświetlania danych stanu lub procesu, za pomocą którego jest generowany klucz.

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

Wartość właściwości

String

Wartość klucza lub wartość wskazująca sposób generowania klucza. Wartość domyślna to "AutoGenerate,IsolateApps".

Atrybuty

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Przykłady

W poniższym przykładzie pokazano, jak ustawić ValidationKey właściwość przy użyciu kodu. Ten przykład jest częścią większego przykładu udostępnionego MachineKeySection dla klasy .

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

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

Uwagi

Właściwość ValidationKey jest używana w przypadku enableViewStateMACtrue tworzenia kodu uwierzytelniania komunikatów (MAC) w celu włączenia ASP.NET w celu określenia, czy stan widoku został naruszony. Właściwość ValidationKey jest również używana do generowania identyfikatorów sesji specyficznych dla aplikacji poza procesem w celu zapewnienia, że zmienne stanu sesji są izolowane między aplikacjami.

Użyj opcji "AutoGenerate", aby określić, że ASP.NET generuje losowy klucz i przechowuje go w lokalnym urzędzie zabezpieczeń. Opcja "AutoGenerate" jest częścią wartości domyślnej.

Jeśli dodasz modyfikator "IsolateApps" do wartości "AutoGenerate" ValidationKey , ASP.NET generuje unikatowy zaszyfrowany klucz dla każdej aplikacji przy użyciu każdej aplikacji AppDomainAppVirtualPath. Jest to ustawienie domyślne.

Jeśli dodasz modyfikator "IsolateByAppId" do wartości "AutoGenerate" ValidationKey , ASP.NET generuje unikatowy zaszyfrowany klucz dla każdej aplikacji przy użyciu każdej aplikacji AppDomainAppId. Jeśli dwie odrębne aplikacje współużytkują ścieżkę wirtualną (na przykład dlatego, że te aplikacje są uruchomione na różnych portach), tej flagi można użyć do dalszego odróżnienia ich od siebie. Flaga "IsolateByAppId" jest rozumiana tylko przez ASP.NET 4.5, ale może być używana niezależnie od MachineKeySection.CompatibilityMode ustawienia.

Jeśli musisz obsługiwać konfigurację w sieci serwerów sieci Web (farma sieci Web), ustaw ValidationKey właściwość ręcznie, aby zapewnić spójną konfigurację. Aby uzyskać informacje na temat ręcznego generowania wartości dla atrybutu DecryptionKey , zobacz How To: Configure MachineKey in ASP.NET 2.0 (Jak skonfigurować klucz maszyny w programie ASP.NET 2.0).

Ta właściwość jest zwykle ustawiana deklaratywnie w validationKey atrybucie elementu machineKey pliku Web.config.