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

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

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

ProfileManager.ApplicationName プロパティ

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

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

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

Visual Basic (宣言)

Public Shared Property ApplicationName
 As String

Visual Basic (使用法)

Dim value As String

value = ProfileManager.ApplicationName

ProfileManager.ApplicationName = value

public static string ApplicationName
 { get; set; }

C++

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

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

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

解説

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

Web アプリケーションの構成ファイルに applicationName 属性の値が指定されていない場合、.NET Framework で含められたプロファイルプロバイダでは、ASP.NET アプリケーションに対して ApplicationVirtualPath プロパティ値を使用します。非 ASP.NET アプリケーションの場合は、既定値はファイル拡張子のない ModuleName プロパティの値になります。

ApplicationName プロパティは、既定のプロファイルプロバイダの SettingsProvider.ApplicationName プロパティを公開します。既定のプロファイルプロバイダは、profile 構成要素の defaultProvider 属性を使用して指定します。ユーザープロファイルに、既定のプロバイダ以外のプロファイルプロバイダによって管理されるプロパティが存在する場合、それらのプロパティは異なるアプリケーション名を使用して設定される場合があります。既定のプロバイダ以外のプロファイルプロバイダのアプリケーション名にアクセスするには、Providers プロパティで目的のプロファイルプロバイダへの参照を取得し、プロバイダの ApplicationName プロパティに直接アクセスします。

注意
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 enabled="true" defaultProvider="SqlProvider">
  <providers>
  <add name="SqlProvider"
    type="System.Web.Profile.SqlProfileProvider"
    connectionStringName="SqlServices"
    applicationName="MyApplication" />
  </providers>
</profile>