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