MachineKeySection.ValidationKey Свойство

Определение

Пространство имен:

System.Web.Configuration

Сборка:

System.Web.dll

Получает или задает ключ, используемый для проверки данных проверки подлинности с помощью форм и просмотра сведений о состоянии, или процесс, благодаря которому создается этот ключ.

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

Значение свойства

String

Значение ключа или значение, указывающее на то, как создается ключ. Значение по умолчанию — AutoGenerate,IsolateApps.

Атрибуты

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Примеры

В следующем примере показано, как задать ValidationKey свойство с помощью кода. Этот пример является частью более крупного примера, предоставленного MachineKeySection для класса.

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

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

Комментарии

Свойство ValidationKey используется при enableViewStateMAC true создании кода проверки подлинности сообщения (MAC), чтобы включить ASP.NET, чтобы определить, было ли изменено состояние представления. Это ValidationKey свойство также используется для создания внепроцессных идентификаторов сеансов, зависящих от приложения, чтобы обеспечить изоляцию переменных состояния сеанса между приложениями.

Используйте параметр AutoGenerate, чтобы указать, что ASP.NET создает случайный ключ и сохраняет его в локальном органе безопасности. Параметр AutoGenerate является частью значения по умолчанию.

При добавлении модификатора IsolateApps в значение AutoGenerate ValidationKey ASP.NET создает уникальный зашифрованный ключ для каждого приложения с помощью каждого приложенияAppDomainAppVirtualPath. Это параметр по умолчанию.

При добавлении модификатора IsolateByAppId в значение AutoGenerate ValidationKey ASP.NET создает уникальный зашифрованный ключ для каждого приложения с помощью каждого приложенияAppDomainAppId. Если два разных приложения совместно используют виртуальный путь (возможно, из-за того, что эти приложения работают на разных портах), этот флаг можно использовать для дальнейшего отличия их друг от друга. Флаг IsolateByAppId распознается только с помощью ASP.NET 4.5, но его можно использовать независимо от MachineKeySection.CompatibilityMode параметра.

Если необходимо поддерживать конфигурацию в сети веб-серверов (веб-фермы), задайте ValidationKey свойство вручную, чтобы обеспечить согласованность конфигурации. Сведения о том, как вручную создавать значения для атрибутаDecryptionKey, см. в разделе "Практическое руководство. Настройка MachineKey в ASP.NET 2.0".

Обычно это свойство задается декларативно в атрибуте validationKey элемента machineKey файла Web.config.