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 podczas enableViewStateMACtrue tworzenia kodu uwierzytelniania komunikatów (MAC), aby umożliwić ASP.NET ustalenie, czy stan widoku został naruszony. Właściwość ValidationKey jest również używana do generowania poza procesem identyfikatorów sesji specyficznych dla aplikacji w celu zapewnienia, że zmienne stanu sesji są izolowane między aplikacjami.

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

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

Jeśli dodasz modyfikator "IsolateByAppId" do wartości "AutoGenerate" ValidationKey , ASP.NET wygeneruje unikatowy zaszyfrowany klucz dla każdej aplikacji przy użyciu poszczególnych aplikacji AppDomainAppId. Jeśli dwie odrębne aplikacje współużytkują ścieżkę wirtualną (na przykład dlatego, że te aplikacje działają 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 (farmy 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 ASP.NET 2.0).

Ta właściwość jest zazwyczaj ustawiana deklaratywnie w atrybucie validationKeyelementu machineKey pliku Web.config.