MachineKeySection.ValidationKey Propriedade

Definição

Espaço de Nomes:
System.Web.Configuration
Assemblagem:
System.Web.dll

Obtém ou define a chave usada para validar a autenticação dos formulários e visualizar os dados de estado, ou o processo pelo qual a chave é gerada.

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

Valor de Propriedade

String

Um valor-chave, ou um valor que indica como a chave é gerada. O padrão é "AutoGeneration, IsolateApps".

Atributos
TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Exemplos

O exemplo seguinte mostra como definir a ValidationKey propriedade usando código. Este exemplo faz parte de um exemplo mais amplo fornecido à MachineKeySection turma.

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

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

Observações

A propriedade ValidationKey é usada quando enableViewStateMAC é true para criar um código de autenticação de mensagem (MAC) que permita ASP.NET determinar se o estado da visualização foi adulterado. A ValidationKey propriedade é também usada para gerar IDs de sessão específicos de aplicação fora do processo, para garantir que as variáveis de estado da sessão são isoladas entre aplicações.

Use a opção "AutoGeneratione" para especificar que o ASP.NET gera uma chave aleatória e a armazena na Autoridade de Segurança Local. A opção "AutoGerar" faz parte do valor padrão.

Se adicionares o modificador "IsolateApps" ao valor "AutoGenerate" ValidationKey, ASP.NET gera uma chave encriptada única para cada aplicação usando o AppDomainAppVirtualPath de cada aplicação. Esta é a predefinição.

Se adicionar o modificador "IsolateByAppId" ao valor "AutoGenerate" ValidationKey, ASP.NET gera uma chave encriptada única para cada aplicação usando o AppDomainAppId de cada aplicação. Se duas aplicações distintas partilham um caminho virtual (talvez porque essas aplicações estão a correr em portas diferentes), esta bandeira pode ser usada para as distinguir ainda mais uma da outra. A flag "IsolateByAppId" é compreendida apenas por ASP.NET 4.5, mas pode ser usada independentemente da definição MachineKeySection.CompatibilityMode.

Se precisar de suportar a configuração numa rede de servidores Web (uma fazenda Web), defina a ValidationKey propriedade manualmente para garantir uma configuração consistente. Para informações sobre como gerar manualmente valores para o atributo DecryptionKey, veja How To: Configure MachineKey em ASP.NET 2.0.

Esta propriedade é normalmente definida declarativamente no validationKey atributo do elemento machineKey do ficheiro Web.config.

Aplica-se a