MachineKeySection.ValidationKey Propriedade

Definição

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Obtém ou define a chave que é usada para validar a autenticação de formulários e exibir 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 da propriedade

String

Um valor de chave ou um valor que indica como a chave é gerada. O padrão é “AutoGenerate,IsolateApps”.

Atributos

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Exemplos

O exemplo a seguir mostra como definir a ValidationKey propriedade usando código. Este exemplo faz parte de um exemplo maior fornecido para a MachineKeySection classe .

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

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

Comentários

A ValidationKey propriedade é usada quando enableViewStateMAC é true para criar um MAC (código de autenticação de mensagem) para habilitar ASP.NET para determinar se o estado de exibição foi adulterado. A ValidationKey propriedade também é usada para gerar IDs de sessão específicas do aplicativo fora do processo para garantir que as variáveis de estado de sessão sejam isoladas entre aplicativos.

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

Se você adicionar o modificador "IsolateApps" ao valor "AutoGenerate", ValidationKey ASP.NET gerará uma chave criptografada exclusiva para cada aplicativo usando o de AppDomainAppVirtualPathcada aplicativo. Essa é a configuração padrão.

Se você adicionar o modificador "IsolateByAppId" ao valor "AutoGenerate", ValidationKey ASP.NET gerará uma chave criptografada exclusiva para cada aplicativo usando o de AppDomainAppIdcada aplicativo. Se dois aplicativos distintos compartilharem um caminho virtual (talvez porque esses aplicativos estão em execução em portas diferentes), esse sinalizador poderá ser usado para diferenciá-los um do outro. O sinalizador "IsolateByAppId" é compreendido apenas pelo ASP.NET 4.5, mas pode ser usado independentemente da MachineKeySection.CompatibilityMode configuração.

Se você precisar dar suporte à configuração em uma rede de servidores Web (um farm da Web), defina a ValidationKey propriedade manualmente para garantir uma configuração consistente. Para obter informações sobre como gerar valores manualmente para o DecryptionKey atributo, consulte How To: Configure MachineKey in ASP.NET 2.0.

Normalmente, essa propriedade é definida declarativamente no validationKey atributo do elemento machineKey do arquivo Web.config.