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ù grande 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 usata quando enableViewStateMAC true si crea un codice di autenticazione del messaggio (MAC) per abilitare ASP.NET per determinare se lo stato di visualizzazione è stato manomesso. La ValidationKey proprietà viene usata anche per generare ID sessione specifici dell'applicazione 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 usando ogni applicazione AppDomainAppVirtualPath. 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 usando ogni applicazione AppDomainAppId. Se due applicazioni distinte condividono un percorso virtuale (forse perché queste applicazioni sono in esecuzione su porte diverse), questo flag può essere usato per distinguerli ulteriormente tra loro. Il flag "IsolateByAppId" viene compreso solo da ASP.NET 4.5, ma può essere usato indipendentemente dall'impostazioneMachineKeySection.CompatibilityMode.

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

Questa proprietà è in genere impostata dichiarativamente nell'attributo dell'elemento validationKey machineKey del file Web.config.