MachineKeySection.ValidationKey Egenskap

Definition

Hämtar eller anger den nyckel som används för att verifiera formulärautentisering och visa tillståndsdata, eller processen som nyckeln genereras genom.

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

Egenskapsvärde

Ett nyckelvärde eller ett värde som anger hur nyckeln genereras. Standardvärdet är "AutoGenerate,IsolateApps".

Attribut

Exempel

I följande exempel visas hur du ValidationKey anger egenskapen med hjälp av kod. Det här exemplet är en del av ett större exempel som tillhandahålls MachineKeySection för klassen.

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

Kommentarer

Egenskapen ValidationKey används när enableViewStateMACtrue för att skapa en kod för meddelandeautentisering (MAC) för att aktivera ASP.NET för att avgöra om visningstillståndet har manipulerats. Egenskapen ValidationKey används också för att generera out-of-process, programspecifika sessions-ID:er för att säkerställa att sessionstillståndsvariabler isoleras mellan program.

Använd alternativet "AutoGenerera" för att ange att ASP.NET genererar en slumpmässig nyckel och lagrar den i den lokala säkerhetsmyndigheten. Alternativet "AutoGenerera" är en del av standardvärdet.

Om du lägger till modifieraren "IsolateApps" i värdet "AutoGenerate" ValidationKey genererar ASP.NET en unik krypterad nyckel för varje program med hjälp av varje programs AppDomainAppVirtualPath. Det här är standardinställningen.

Om du lägger till modifieraren "IsolateByAppId" i värdet "AutoGenerate" ValidationKey genererar ASP.NET en unik krypterad nyckel för varje program med hjälp av varje programs AppDomainAppId. Om två distinkta program delar en virtuell sökväg (kanske eftersom programmen körs på olika portar) kan den här flaggan användas för att ytterligare skilja dem från varandra. Flaggan "IsolateByAppId" förstås endast av ASP.NET 4.5, men den kan användas oavsett inställningen MachineKeySection.CompatibilityMode.

Om du behöver stöd för konfiguration i ett nätverk av webbservrar (en webbgrupp) anger du ValidationKey egenskapen manuellt för att säkerställa konsekvent konfiguration. Information om hur du manuellt genererar värden för attributet DecryptionKey finns i How To: Configure MachineKey in ASP.NET 2.0.

Den här egenskapen anges vanligtvis deklarativt i validationKey attributet för machineKey-elementet i Web.config-filen.

Gäller för