MachineKeySection.DecryptionKey Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает ключ, используемый для шифрования и расшифровки данных, или процесс, с помощью которого создается ключ.
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
Значение свойства
Значение ключа или значение, указывающее на то, как создается ключ. Значение по умолчанию — AutoGenerate,IsolateApps.
- Атрибуты
Примеры
В следующем примере показано, как задать 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
, см. в разделе How To: Configure MachineKey in ASP.NET 2.0.
Обычно это свойство задается декларативно в атрибуте DecryptionKey
элемента machineKey файла Web.config. Дополнительные сведения см. в разделе элемент machineKey .