AnonymousIdentificationSection クラス 1

  • [アーティクル]

Web アプリケーションで Cookie を使用する方法を指定します。

構文

class AnonymousIdentificationSection : ConfigurationSection

メソッド

次の表に、AnonymousIdentificationSection クラスによって公開されるメソッドの一覧を示します。

名前 説明
GetAllowDefinition (ConfigurationSection から継承。)
GetAllowLocation (ConfigurationSection から継承。)
RevertToParent (ConfigurationSection から継承。)
SetAllowDefinition (ConfigurationSection から継承。)
SetAllowLocation (ConfigurationSection から継承。)

プロパティ

次の表は、AnonymousIdentificationSection クラスによって公開されるプロパティの一覧です。

名前 説明
Cookieless Web アプリケーションで Cookie を使用するかどうかを指定する読み取り/書き込みの sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。
CookieName Cookie に割り当てられる名前を指定する読み取り/書き込みの string 値。 既定値は ".ASPXANONYMOUS" です。
CookiePath Cookie が格納されているディレクトリへのパスを指定する読み取り/書き込みの string 値。 既定値はルート ディレクトリで、"/" で指定されます。
CookieProtection Cookie 保護スキームを指定する読み取り/書き込みの sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。
CookieRequireSSL 読み取り/書き込みの boolean 値。 Cookie がクライアントに送信されるときに、Secure Sockets Layer (SSL) 接続が必要な場合は、true、それ以外の場合は、false。 既定値は、false です。

ASP.NET の Secure 認証 Cookie プロパティを設定すると、SSL 接続が使用されている場合にのみ、クライアントによって Cookie が返されます。
CookieSlidingExpiration 必要な読み取り/書き込みの boolean 値。 Cookie の有効期限が最初に現在の日付と時刻に CookieTimeout プロパティ内の値 (分単位) を加えた値に設定される場合は true、それ以外の場合は false。 既定値は、true です。

true の場合で、かつ CookieTimeout の値の半分以下が残っており、ユーザーがまだアクティブにアプリケーションを使用している場合、Cookie の有効期限の日付と時刻は自動的に更新されます。 false の場合、CookieTimeout プロパティで指定された時間間隔が経過すると、Cookie は自動的にタイムアウトします。 詳細については、System.Web.HttpCookie.Expires プロパティを参照してください。
CookieTimeout Cookie の有効期限の期間を指定する必要な読み取り/書き込みの datetime 値。 既定値は 69 日 10 時間 40 分で、これは 10000 分に相当します。
Domain Cookie ドメインを指定する読み取り/書き込みの string 値。 既定値は、空の文字列 ("") です。

このプロパティを使用すると、共通のドメイン ネーム システム (DNS) 名前空間 (たとえば、"contoso.com" で終わるすべてのサイト) を持つドメイン間で匿名 ID Cookie を共有できます。 匿名 ID Cookie を共有するには、サイトで共通の復号化キーと検証キーを共有する必要があります。 Cookie パスや Cookie 名など、その他の匿名 ID 構成属性は、すべてのサイトで同じである必要があります。 詳細については、System.Web.HttpCookie クラスを参照してください。
Enabled オプションの読み取り/書き込みの boolean 値。 匿名 ID が有効になっている場合は true、そうでない場合は false。 true の場合は、Cookie (または Cookie なしの値) を使用してユーザーの匿名識別子を管理します。 既定値は、false です。
Location (ConfigurationSection から継承。)キー プロパティ。
Path (ConfigurationSection から継承。)キー プロパティ。
SectionInformation (ConfigurationSection から継承。)

サブクラス

このクラスにはサブクラスが含まれていません。

解説

次の表に、Cookieless プロパティとして使用できる値の一覧を示します。 既定値は 1 (UseCookies) です。

Value キーワード 説明
0 UseUri ブラウザーやデバイスで Cookie をサポートしているかどうかに関係なく、呼び出し元の機能でクエリ文字列を使用して識別子が格納されることを指定します。
1 UseCookies ブラウザーやデバイスで Cookie をサポートしているかどうかに関係なく、ユーザー データを保持するために Cookie が使用されることを指定します。
2 AutoDetect 要求元のブラウザーやデバイスで Cookie をサポートしているかどうかが ASP.NET によって決まることを指定します。 要求元のブラウザーやデバイスで Cookie をサポートしている場合、AutoDetect では Cookie を使用してユーザー データが保持されます。それ以外の場合、クエリ文字列内で識別子が使用されます。 ブラウザーやデバイスで Cookie をサポートしているが、Cookie が現在無効になっている場合、要求元の機能で Cookie が引き続き使用されます。
3 UseDeviceProfile System.Web.Configuration.HttpCapabilitiesBase.Cookies プロパティに基づいて Cookie を使用するかどうかが ASP.NET によって決まることを指定します。 ブラウザーやデバイスで Cookie をサポートすることが設定で指定されている場合、Cookie が使用されます。それ以外の場合、クエリ文字列内で識別子が使用されます。

次の表に、CookieProtection プロパティとして使用できる値の一覧を示します。 既定値は 1 (Validation) です。

Value キーワード 説明
0 None Cookie 情報が保護されていないことを指定します。 Cookie の情報はクリア テキストで保存され、情報がサーバーに返送されるときに検証されません。
1 Validation 情報がサーバーに送り返される前に、Cookie 内の情報が変更されていないことを確認します。
2 Encryption Cookie 内の情報を暗号化します。
3 All Cookie 内の情報を保護するために、Validation 値と Encryption 値の両方が使用されることを指定します。

継承階層

ConfigurationSection

AnonymousIdentificationSection

要件

型 説明
クライアント - Windows Vista 上の IIS 7.0
- Windows 7 上の IIS 7.5
- Windows 8 上の IIS 8.0
- Windows 10 上の IIS 10.0
[サーバー] - Windows Server 2008 上の IIS 7.0
- Windows Server 2008 R2 上の IIS 7.5
- Windows Server 2012 上の IIS 8.0
- Windows Server 2012 R2 上の IIS 8.5
- Windows Server 2016 上の IIS 10.0
Product - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル WebAdministration.mof

参照

System.Web.Configuration.SystemWebSectionGroup.AnonymousIdentification System.Web.HttpCookie.Expires
System.Web.HttpCookie.Secure
System.Web.HttpCookie System.Web.HttpCookieMode ConfigurationSection クラス
CIM_DATETIME