MachineKeySection.ValidationKey プロパティ

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

プロパティ値

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

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

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

"AutoGenerate" ValidationKey 値に "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属性で宣言によって設定されます。