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

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

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

SqlProfileProvider.ApplicationName プロパティ

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

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

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

Visual Basic (宣言)

Public Overrides Property
 ApplicationName As String

Visual Basic (使用法)

Dim instance As SqlProfileProvider
Dim value As String

value = instance.ApplicationName

instance.ApplicationName = value

public override string ApplicationName { get;
 set; }

C++

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

/** @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)

プロパティ値
プロファイル情報を格納および取得するアプリケーションの名前。既定値は ApplicationVirtualPath です。

例外

例外の種類	条件
HttpException	ASP.NET の High ホスト許可を持たない呼び出し元が、ApplicationName プロパティを設定しようとしました。
System.Configuration.Provider.ProviderException	ApplicationName プロパティに対し、256 文字より長い文字列を設定しようとしました。

解説

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

Web アプリケーションの構成ファイルに applicationName 属性が指定されていない場合、ASP.NET アプリケーションでは ApplicationVirtualPath の値が使用されます。非 ASP.NET アプリケーションの場合は、既定値はファイル拡張子のない ModuleName の値になります。

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

注意

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

使用例

次のコード例は、ASP.NET アプリケーションの Web.config ファイルの system.web セクションにある profile 要素を示しています。アプリケーションの SqlProfileProvider インスタンスを指定し、ApplicationName プロパティ値を MyApplication に設定しています。

<profile defaultProvider="SqlProvider">
  <providers>
    <add name="SqlProvider"
      type="System.Web.Profile.SqlProfileProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
   </providers>
</profile>