MachineKeySection.ValidationKey Vlastnost

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Získá nebo nastaví klíč, který se používá k ověření ověřování formulářů a zobrazení dat stavu, nebo proces, podle kterého je klíč generován.

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

Hodnota vlastnosti

String

Hodnota klíče nebo hodnota, která určuje, jak je klíč generován. Výchozí hodnota je AutoGenerate, IsolateApps.

Atributy

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Příklady

Následující příklad ukazuje, jak nastavit ValidationKey vlastnost pomocí kódu. Tento příklad je součástí většího příkladu poskytnutého MachineKeySection pro třídu .

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

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

Poznámky

Vlastnost slouží ValidationKeyenableViewStateMACtrue k vytvoření ověřovacího kódu zprávy (MAC), který umožňuje ASP.NET určit, jestli se stavem zobrazení někdo manipuloval. Vlastnost ValidationKey se také používá ke generování ID relací specifických pro aplikaci mimo proces, aby se zajistilo, že proměnné stavu relace jsou izolované mezi aplikacemi.

Pomocí možnosti Automaticky vygenerovat určíte, že ASP.NET vygeneruje náhodný klíč a uloží ho do místní autority zabezpečení. Možnost Automaticky vygenerovat je součástí výchozí hodnoty.

Pokud k hodnotě AutoGenerate ValidationKey přidáte modifikátor IsolateApps, ASP.NET vygeneruje jedinečný šifrovaný klíč pro každou aplikaci pomocí AppDomainAppVirtualPathmetody . Toto je výchozí nastavení.

Pokud přidáte modifikátor "IsolateByAppId" k hodnotě "AutoGenerate" ValidationKey , ASP.NET vygeneruje jedinečný šifrovaný klíč pro každou aplikaci pomocí AppDomainAppIdmetody . Pokud virtuální cestu sdílejí dvě odlišné aplikace (třeba proto, že tyto aplikace běží na různých portech), můžete tento příznak použít k jejich dalšímu rozlišení. Příznak "IsolateByAppId" rozumí jenom ASP.NET 4.5, ale dá se použít bez ohledu na MachineKeySection.CompatibilityMode nastavení.

Pokud potřebujete podporovat konfiguraci v síti webových serverů (webová farma), nastavte ValidationKey vlastnost ručně, aby se zajistila konzistentní konfigurace. Informace o ručním generování hodnot pro DecryptionKey atribut naleznete v tématu Postupy: Konfigurace MachineKey v ASP.NET 2.0.

Tato vlastnost se obvykle nastavuje deklarativně v atributu validationKeyelementu machineKey souboru Web.config.