MachineKeySection.ValidationKey Vlastnost

Definice

Obor názvů:

System.Web.Configuration

Sestavení:

System.Web.dll

Získá nebo nastaví klíč, který slouží k ověření ověřování formulářů a zobrazení stavových dat, nebo proces, pomocí kterého se klíč vygeneruje.

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 se klíč generuje. 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 ValidationKey se používá enableViewStateMACtrue při vytváření ověřovacího kódu zprávy (MAC), který umožňuje ASP.NET určit, zda byl stav zobrazení manipulován. Tato ValidationKey vlastnost se také používá k vygenerování ID relací specifických pro jednotlivé procesy, aby se zajistilo, že proměnné stavu relace jsou izolované mezi aplikacemi.

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

Pokud přidáte modifikátor "IsolateApps" do hodnoty "AutoGenerate" ValidationKey , ASP.NET vygeneruje jedinečný šifrovaný klíč pro každou aplikaci pomocí každé aplikace AppDomainAppVirtualPath. Toto je výchozí nastavení.

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

Pokud potřebujete podporovat konfiguraci v síti webových serverů (webová farma), nastavte ValidationKey vlastnost ručně, aby byla zajištěna 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 je obvykle nastavena deklarativní v validationKeyatributu machineKey elementu Web.config souboru.