MachineKeySection.DecryptionKey Свойство

Определение

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

System.Web.Configuration

Сборка:

System.Web.dll

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

public:
 property System::String ^ DecryptionKey { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))]
[System.Configuration.ConfigurationProperty("decryptionKey", DefaultValue="AutoGenerate,IsolateApps")]
[System.Configuration.StringValidator(MinLength=1)]
public string DecryptionKey { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))>]
[<System.Configuration.ConfigurationProperty("decryptionKey", DefaultValue="AutoGenerate,IsolateApps")>]
[<System.Configuration.StringValidator(MinLength=1)>]
member this.DecryptionKey : string with get, set

Public Property DecryptionKey As String

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

String

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

Атрибуты

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Примеры

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

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

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

Комментарии

Свойство DecryptionKey используется для шифрования и расшифровки, таких как проверка подлинности Windows Forms, а также для состояния просмотра, если Validation свойству присвоено значение "3DES" или "AES".

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

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

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

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

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

См. также раздел

• MachineKeySection