SqlProfileProvider.ApplicationName プロパティ

.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

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)

プロパティ値
プロファイル情報を格納および取得するアプリケーションの名前。既定値は 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 アプリケーションではなく、シングルユーザー アプリケーションにしてください。

使用例

次のコード例は、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>

プラットフォーム

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

参照

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