SqlRoleProvider.ApplicationName プロパティ

  • リファレンス

定義

名前空間:
System.Web.Security
アセンブリ:
System.Web.dll

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

public:
 virtual property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };
public override string ApplicationName { get; set; }
member this.ApplicationName : string with get, set
Public Overrides Property ApplicationName As String

プロパティ値

String

ロール情報を保管および取得するアプリケーションの名前。 既定値は、現在の ApplicationPath の Request プロパティ値です。

例外

HttpException

ASP.NET の ApplicationName ホスト許可を持たない呼び出し元が、High プロパティを設定しようとしました。

ProviderException

ApplicationName に 256 文字を超える文字列を設定しようとしました。

例

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

<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>

注釈

これは ApplicationName 、ユーザーとロールを SqlRoleProvider さまざまなアプリケーションに関連付けるために使用されます。 これにより、複数のアプリケーションで同じデータベースを使用して、重複するユーザー名またはロール名の間で競合することなく、ユーザーとロールの情報を格納できます。 複数の ASP.NET アプリケーションでは、プロパティに同じ値を指定することで、同じデータベースをApplicationName使用できます。 プロパティは ApplicationName プログラムで設定することも、属性を使用して applicationName Web アプリケーションの構成ファイルで宣言によって設定することもできます。

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

注意事項

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

適用対象

こちらもご覧ください