Roles.ApplicationName プロパティ

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

Roles.ApplicationName プロパティ

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

ロール情報を保管および取得するアプリケーションの名前を取得または設定します。

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

Visual Basic (宣言)

Public Shared Property ApplicationName
 As String

Visual Basic (使用法)

Dim value As String

value = Roles.ApplicationName

Roles.ApplicationName = value

C#

public static string ApplicationName
 { get; set; }

C++

public:
static property String^ ApplicationName {
    String^ get ();
    void set (String^ value);
}

J#

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

/** @property */
public static void set_ApplicationName
 (String value)

JScript

public static function get
 ApplicationName () : String

public static function set
 ApplicationName (value : String)

プロパティ値
ロール情報を保管および取得するアプリケーションの名前。

解説

ApplicationName プロパティは、Roles クラスがユーザーとロールを複数のアプリケーションに関連付けるために使用します。これによって、ユーザー名やロール名の重複による競合を発生させずに複数のアプリケーションが同じデータ ソースを使用してユーザーとロール情報を保存できます。複数の ASP.NET アプリケーションは、ApplicationName プロパティに同じ値を指定することによって同じデータ ソースを使用できます。ApplicationName プロパティは、プログラムによって設定するか、または Web アプリケーションの構成ファイルで applicationName 属性を使用して宣言することによって設定できます。

Web アプリケーションが SqlRoleProvider クラスを使用し、構成ファイルで applicationName 属性に値が指定されていない場合は、現在の HttpContext.Request プロパティの HttpRequest.ApplicationPath プロパティ値が使用されます。

注意

HttpApplication オブジェクトが処理するすべての要求に単一の既定のロール プロバイダ インスタンスが使用されるので、複数の要求が同時に動作して ApplicationName プロパティ値を設定できます。ApplicationName プロパティは、複数の書き込みでは、スレッド セーフではありません。また、ApplicationName プロパティの値を変更すると、アプリケーションの複数のユーザーに対して、予期しない動作が発生する場合があります。必要な場合を除いて、ユーザーによる ApplicationName プロパティの設定を許可するコードは記述しないでください。ApplicationName プロパティの設定を必要とするアプリケーションの例としては、複数のアプリケーションのロール データを管理するアプリケーションがあります。このような管理アプリケーションは、Web アプリケーションではなく、シングルユーザー アプリケーションにする必要があります。

使用例

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

<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

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Roles クラス
Roles メンバ
System.Web.Security 名前空間
その他の技術情報
ロール管理について