MachineKeySection.ValidationKey Propiedad

Definición

Espacio de nombres:

System.Web.Configuration

Ensamblado:

System.Web.dll

Obtiene o establece la clave que se utiliza para validar la autenticación de formularios y datos del estado de vista, o el proceso por el que se genera la clave.

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 propiedad

String

Un valor de clave o un valor que indica cómo se genera la clave. El valor predeterminado es "AutoGenerate,IsolateApps".

Atributos

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la ValidationKey propiedad mediante código. Este ejemplo forma parte de un ejemplo más grande proporcionado para la MachineKeySection clase .

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

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

Comentarios

La ValidationKey propiedad se usa cuando enableViewStateMAC se true crea un código de autenticación de mensajes (MAC) para habilitar ASP.NET para determinar si se ha alterado el estado de vista. La ValidationKey propiedad también se usa para generar identificadores de sesión específicos de la aplicación fuera del proceso para asegurarse de que las variables de estado de sesión están aisladas entre las aplicaciones.

Use la opción "AutoGenerate" para especificar que ASP.NET genera una clave aleatoria y la almacena en la entidad de seguridad local. La opción "AutoGenerate" forma parte del valor predeterminado.

Si agrega el modificador "IsolateApps" al valor "AutoGenerate", ValidationKey ASP.NET genera una clave cifrada única para cada aplicación mediante el uso de AppDomainAppVirtualPath. Esta es la configuración predeterminada.

Si agrega el modificador "IsolateByAppId" al valor "AutoGenerate", ValidationKey ASP.NET genera una clave cifrada única para cada aplicación mediante el uso de AppDomainAppId. Si dos aplicaciones distintas comparten una ruta de acceso virtual (quizás porque esas aplicaciones se ejecutan en puertos diferentes), esta marca se puede usar para distinguirlas entre sí. La marca "IsolateByAppId" solo se entiende por ASP.NET 4.5, pero se puede usar independientemente de la MachineKeySection.CompatibilityMode configuración.

Si necesita admitir la configuración en una red de servidores web (una granja de servidores web), establezca la ValidationKey propiedad manualmente para garantizar una configuración coherente. Para obtener información sobre cómo generar manualmente valores para el DecryptionKey atributo, vea How To: Configure MachineKey in ASP.NET 2.0.

Esta propiedad normalmente se establece declarativamente en el validationKey atributo del elemento machineKey del archivo Web.config.