ProfileManager.ApplicationName プロパティ

.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

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)

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

解説

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 アプリケーションではなく、シングルユーザー アプリケーションにしてください。

使用例

次に示す構成ファイルからの抜粋は、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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
ProfileManager クラス
ProfileManager メンバ
System.Web.Profile 名前空間
その他の技術情報
ASP.NET プロファイル プロパティ