AuthorizationStoreRoleProvider.ApplicationName プロパティ

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

AuthorizationStoreRoleProvider.ApplicationName プロパティ

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

ロール情報を格納および取得する承認ストア アプリケーションの名前を取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 ApplicationName As String

Visual Basic (使用法)

Dim instance As AuthorizationStoreRoleProvider
Dim value As String

value = instance.ApplicationName

instance.ApplicationName = value

C#

public override string ApplicationName { get;
 set; }

C++

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

J#

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

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

JScript

public override function get
 ApplicationName () : String

public override function set
 ApplicationName (value : String)

プロパティ値
ロール情報を格納および取得する承認ストア アプリケーションの名前。既定値は、現在の HttpContext.Request の HttpRequest.ApplicationPath プロパティ値です。

例外

例外の種類	条件
ProviderException	ApplicationName に 256 文字を超える文字列を設定しようとしました。

解説

ApplicationName は、AuthorizationStoreRoleProvider が、ユーザーとロールを承認マネージャ アプリケーションに関連付ける目的で使用します。これにより、複数の ASP.NET アプリケーションが、ロール名の競合が発生しないように、同じ承認マネージャ ポリシー ストアを使用してロール情報を格納できます。または、ApplicationName プロパティに同じ値を指定することにより、複数の ASP.NET アプリケーションが同じポリシー ストアを使用することもできます。ApplicationName プロパティは、プログラムによって設定することも、アプリケーションの Web.config ファイルで applicationName 属性で宣言することによって設定することもできます。

Web.config ファイルに applicationName 属性の値が指定されていない場合は、現在の HttpContext.Request オブジェクトの HttpRequest.ApplicationPath プロパティ値が使用されます。

注意

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

使用例

ASP.NET アプリケーションの Web.config ファイルの system.web セクションの roleManager 要素の例を次に示します。アプリケーションの AuthorizationStoreRoleProvider インスタンスを指定し、ApplicationName プロパティを MyApplication に設定します。

<roleManager defaultProvider="AuthorizationStoreProvider" 
  enabled="true"
  cacheRolesInCookie="true"
  cookieName=".ASPROLES"
  cookieTimeout="30"
  cookiePath="/"
  cookieRequireSSL="false"
  cookieSlidingExpiration="true"
  cookieProtection="All" >
  <providers>
    <add
      name="SqlProvider"
      type="System.Web.Security.AuthorizationStoreRoleProvider"
      connectionStringName="AuthorizationStoreServices" 
      scopeName="MyScope"
      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

参照

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