MachineKeySection.ValidationKey Proprietà

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

Ottiene o imposta la chiave usata per convalidare l'autenticazione basata su form e visualizzare i dati relativi allo stato o il processo in base al quale viene generata la chiave.

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

Valore della proprietà

String

Valore della chiave oppure un valore che indica come viene generata la chiave. Il valore predefinito è "AutoGenerate,IsolateApps".

Attributi

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Esempio

Nell'esempio seguente viene illustrato come impostare la proprietà usando il ValidationKey codice . Questo esempio fa parte di un esempio più ampio fornito per la MachineKeySection classe .

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

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

Commenti

La ValidationKey proprietà viene utilizzata quando enableViewStateMAC si true crea un codice mac (Message Authentication Code) per consentire ASP.NET di determinare se lo stato di visualizzazione è stato manomesso. La ValidationKey proprietà viene usata anche per generare ID sessione specifici dell'applicazione out-of-process per garantire che le variabili di stato della sessione siano isolate tra le applicazioni.

Usare l'opzione "AutoGenerate" per specificare che ASP.NET genera una chiave casuale e la archivia nell'autorità di sicurezza locale. L'opzione "AutoGenerate" fa parte del valore predefinito.

Se si aggiunge il modificatore "IsolateApps" al valore "AutoGenerate", ValidationKey ASP.NET genera una chiave crittografata univoca per ogni applicazione AppDomainAppVirtualPathusando . Si tratta dell'impostazione predefinita.

Se si aggiunge il modificatore "IsolateByAppId" al valore "AutoGenerate", ValidationKey ASP.NET genera una chiave crittografata univoca per ogni applicazione AppDomainAppIdusando . Se due applicazioni distinte condividono un percorso virtuale ,ad esempio perché tali applicazioni sono in esecuzione su porte diverse, questo flag può essere usato per distinguerli ulteriormente l'uno dall'altro. Il flag "IsolateByAppId" viene riconosciuto solo da ASP.NET 4.5, ma può essere usato indipendentemente dall'impostazione MachineKeySection.CompatibilityMode .

Se è necessario supportare la configurazione in una rete di server Web (una Web farm), impostare manualmente la ValidationKey proprietà per garantire una configurazione coerente. Per informazioni su come generare manualmente i valori per l'attributo DecryptionKey , vedere Procedura: Configurare MachineKey in ASP.NET 2.0.

Questa proprietà viene in genere impostata in modo dichiarativo nell'attributo dell'elemento validationKeymachineKey del file Web.config.