MachineKeySection.DecryptionKey Свойство

Определение

Получает или задает ключ, используемый для шифрования и расшифровки данных, или процесс, с помощью которого создается ключ.Gets or sets the key that is used to encrypt and decrypt data, or the process by which the key is generated.

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=Mono.Cecil.CustomAttributeArgument)]
[System.Configuration.StringValidator(MinLength=1)]
public string DecryptionKey { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))>]
[<System.Configuration.ConfigurationProperty("decryptionKey", DefaultValue=Mono.Cecil.CustomAttributeArgument)>]
[<System.Configuration.StringValidator(MinLength=1)>]
member this.DecryptionKey : string with get, set
Public Property DecryptionKey As String

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

String

Значение ключа или значение, указывающее на то, как создается ключ.A key value, or a value that indicates how the key is generated. Значение по умолчанию — AutoGenerate,IsolateApps.The default is "AutoGenerate,IsolateApps".

Атрибуты

Примеры

В следующем примере показано, как задать DecryptionKey свойство с помощью кода.The following example demonstrates how to set the DecryptionKey property by using code. Этот пример является частью большого примера, приведенного для MachineKeySection класса.This example is part of a larger example provided for the MachineKeySection class.

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

Комментарии

DecryptionKeyСвойство используется для шифрования и расшифровки, например в Windows Forms проверки подлинности, а также для состояния просмотра, если Validation свойство имеет значение 3DES или AES.The DecryptionKey property is used for encryption and decryption, such as in Windows Forms authentication, and for view state when the Validation property is set to "3DES" or "AES".

Используйте параметр "Автоформирование", чтобы указать, что ASP.NET создает случайный ключ и сохраняет его в локальном центре безопасности.Use the "AutoGenerate" option to specify that ASP.NET generates a random key and stores it in the Local Security Authority. Параметр "Автоформирование" является частью значения по умолчанию.The "AutoGenerate" option is part of the default value.

При добавлении модификатора "IsolateApps" к значению "автоформирования" ValidationKey ASP.NET создает уникальный зашифрованный ключ для каждого приложения с помощью каждого приложения AppDomainAppVirtualPath .If you add the "IsolateApps" modifier to the "AutoGenerate" ValidationKey value, ASP.NET generates a unique encrypted key for each application by using each application's AppDomainAppVirtualPath. Это параметр по умолчанию.This is the default setting.

При добавлении модификатора "Исолатебяппид" к значению "автоформирования" ValidationKey ASP.NET создает уникальный зашифрованный ключ для каждого приложения с помощью каждого приложения AppDomainAppId .If you add the "IsolateByAppId" modifier to the "AutoGenerate" ValidationKey value, ASP.NET generates a unique encrypted key for each application by using each application's AppDomainAppId. Если два различных приложения совместно используют виртуальный путь (возможно, так как эти приложения работают на разных портах), можно использовать этот флаг, чтобы дополнительно отличить их друг от друга.If two distinct applications share a virtual path (perhaps because those applications are running on different ports), this flag can be used to further distinguish them from one another. Флаг "Исолатебяппид" понятен только ASP.NET 4,5, но его можно использовать независимо от MachineKeySection.CompatibilityMode параметра.The "IsolateByAppId" flag is understood only by ASP.NET 4.5, but it can be used regardless of the MachineKeySection.CompatibilityMode setting.

Если требуется поддержка конфигурации в сети веб-серверов (веб-ферма), задайте DecryptionKey свойство вручную, чтобы обеспечить согласованную конфигурацию.If you need to support configuration across a network of Web servers (a Web farm), set the DecryptionKey property manually to ensure consistent configuration. Сведения о том, как вручную создавать значения для DecryptionKey атрибута, см. в разделе как настроить MachineKey в ASP.NET 2,0.For information about how to manually generate values for the DecryptionKey attribute, see How To: Configure MachineKey in ASP.NET 2.0.

Обычно это свойство задается декларативно в DecryptionKey атрибуте элемента machineKey файла Web.config.This property is typically set declaratively in the DecryptionKey attribute of the machineKey element of the Web.config file. Дополнительные сведения см. в описании элемента machineKey .For more information, see the machineKey element.

Применяется к

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