FormsAuthentication.CookieMode プロパティ

.NET Framework クラス ライブラリ リファレンス

FormsAuthentication.CookieMode プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーションが cookieless フォーム認証用として構成されているかどうかを示す値を取得します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Shared ReadOnly Property
 CookieMode As HttpCookieMode

Visual Basic (使用法)

Dim value As HttpCookieMode

value = FormsAuthentication.CookieMode

C#

public static HttpCookieMode CookieMode { get;
 }

C++

public:
static property HttpCookieMode CookieMode {
    HttpCookieMode get ();
}

J#

/** @property */
public static HttpCookieMode get_CookieMode
 ()

JScript

public static function get
 CookieMode () : HttpCookieMode

プロパティ値
アプリケーションが cookieless フォーム認証用に構成されているかどうかを示す HttpCookieMode 値の 1 つ。既定値は UseDeviceProfile です。

解説

CookieMode プロパティは、forms 構成要素の cookieless 属性の値を反映します。CookieMode プロパティは、FormsAuthenticationTicket 値をブラウザのセッション Cookie に格納するか QueryString プロパティに格納するかを決定します。

メモ
FormsAuthenticationTicket 値を URI に格納する場合には、生成される URI の長さが許容されている最大長を超えることがあります。これは通常、FormsCookiePath プロパティにアプリケーション名が設定されていて、そのアプリケーション名が長い (40 文字以上) 場合、アプリケーションのユーザー名が長い場合、または長い UserData 文字列が FormsAuthenticationTicket 値に格納されている場合に発生します。生成された URI が長すぎる場合、Web サーバーは 400 - Bad Request エラーを返します。

使用例

Web.config ファイルの cookieless 属性を AutoDetect に設定するコード例を次に示します。

<authentication mode="Forms">
  <forms loginUrl="member_login.aspx"
    cookieless="UseCookies" />
</authentication>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FormsAuthentication クラス
FormsAuthentication メンバ
System.Web.Security 名前空間
その他の技術情報
ASP.NET Web アプリケーションのセキュリティ