Roles.CookieName プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Roles.CookieName プロパティ

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

ロール名がキャッシュされている Cookie の名前を取得します。

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

Visual Basic (宣言)

Public Shared ReadOnly Property
 CookieName As String

Visual Basic (使用法)

Dim value As String

value = Roles.CookieName

public static string CookieName
 { get; }

C++

public:
static property String^ CookieName {
    String^ get ();
}

/** @property */
public static String get_CookieName ()

JScript

public static function get
 CookieName () : String

プロパティ値
ロール名がキャッシュされている Cookie の名前。既定値は .ASPXROLES です。

解説

ASP.NET アプリケーションの Web.config ファイルで cookieName 属性を設定することで、そのアプリケーションに対してロールをキャッシュする Cookie の名前を指定できます。これは、アプリケーションの Cookie を一意に識別する場合や、ドメイン Cookie のように Cookie が複数のアプリケーションで共有される場合に役に立ちます。

使用例

ASP.NET アプリケーションの Web.config ファイルの system.web セクションの roleManager 要素の例を次に示します。この例では、アプリケーションが SqlRoleProvider インスタンスを使用することを指定し、cookieName 属性を .ASPROLES に設定します。

<roleManager defaultProvider="SqlProvider" 
  enabled="true"
  cacheRolesInCookie="true"
  cookieName=".ASPROLES"
  cookieTimeout="30"
  cookiePath="/"
  cookieRequireSSL="false"
  cookieSlidingExpiration="true"
  cookieProtection="All" >
  <providers>
    <add
      name="SqlProvider"
      type="System.Web.Security.SqlRoleProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
  </providers>
</roleManager>

プラットフォーム

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