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、メッセージ認証コード (MAC) を作成して、ビューステートが改ざんされているかどうかを判断するために ASP.NET を有効にする場合enableViewStateMAC``trueに使用されます。 この ValidationKey プロパティは、セッション状態変数がアプリケーション間で確実に分離されるように、アウトプロセスのアプリケーション固有のセッション ID を生成するためにも使用されます。

"AutoGenerate" オプションを使用して、ASP.NET がランダム キーを生成し、ローカル セキュリティ機関に格納することを指定します。 "AutoGenerate" オプションは既定値の一部です。

"AutoGenerateValidationKey" 値に "IsolateApps" 修飾子を追加すると、ASP.NET は、各アプリケーションを使用してアプリケーションごとに一意のAppDomainAppVirtualPath暗号化キーを生成します。 これが既定の設定です。

"AutoGenerateValidationKey" 値に "IsolateByAppId" 修飾子を追加すると、ASP.NET は、各アプリケーションを使用してアプリケーションごとに一意のAppDomainAppId暗号化キーを生成します。 2 つの異なるアプリケーションが仮想パスを共有する場合 (これらのアプリケーションが異なるポートで実行されている可能性があるため)、このフラグを使用して、それらを相互に区別できます。 "IsolateByAppId" フラグは、ASP.NET 4.5 でのみ認識されますが、設定にMachineKeySection.CompatibilityMode関係なく使用できます。

Web サーバー (Web ファーム) のネットワーク経由での構成をサポートする必要がある場合は、一貫性のある構成を確保するためにプロパティを ValidationKey 手動で設定します。 属性の値DecryptionKeyを手動で生成する方法については、「方法: ASP.NET 2.0 で MachineKey を構成する」を参照してください。

このプロパティは、通常、Web.config ファイルの machineKey 要素の属性で宣言によってvalidationKey設定されます。