SqlProfileProvider

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

SqlProfileProvider クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

SQL Server データベース内にある ASP.NET アプリケーションに関するプロファイル情報のストレージを管理します。

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

Visual Basic (宣言)

Public Class SqlProfileProvider
    Inherits ProfileProvider

Visual Basic (使用法)

Dim instance As SqlProfileProvider

C#

public class SqlProfileProvider : ProfileProvider

C++

public ref class SqlProfileProvider : public
 ProfileProvider

J#

public class SqlProfileProvider extends ProfileProvider

JScript

public class SqlProfileProvider extends
 ProfileProvider

解説

ASP.NET プロファイルは、データベースなどのデータ ソース内にあるユーザー設定値の格納と取得に使用されます。ユーザー プロファイルには、現在の HttpContext の Profile プロパティを使用してアクセスします。プロファイルの情報とプロパティ値は、プロファイル プロバイダを使用して管理されます。

SQL Server データベースを使用している ASP.NET アプリケーションのプロファイル設定値の格納と取得を行うために、SqlProfileProvider クラスが ASP.NET によって使用されます。SqlProfileProvider を使用するには、最初に SqlProfileProvider で使用される SQL Server データベースを作成する必要があります。SqlProfileProvider で使用されるデータベースを作成するには、[drive:]\WINDOWS\Microsoft.NET\Framework\versionNumber フォルダにある aspnet_regsql.exe ツールに -Ap オプションを指定して実行します。次に、aspnet_regsql.exe 実行可能ファイルを使用するコマンド例を示します。

aspnet_regsql.exe -Ap

上の例では作成するデータベースの名前を指定していないため、既定の名前が使用されます。既定のデータベース名は Aspnetdb です。

コンピュータの構成には、ローカル コンピュータ上の SQL Server へ接続するための AspNetSqlProvider という名前の既定 SqlProfileProvider インスタンスが含まれます。プロバイダのこのインスタンスを使用することも、ASP.NET アプリケーションの Web.config ファイルで独自に指定することもできます。

メモ
プロファイル プロバイダが、統合セキュリティを使用する接続文字列を使用するように設定されている場合、ASP.NET アプリケーションのプロセス アカウントには SQL Server データベースへの接続権限が必要です。

使用例

SqlProfileProvider を使用するように構成された ASP.NET アプリケーションの Web.config のコード例を次に示します。

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString=
      "Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;"
 />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
    </authentication>
    <authorization>
      <deny users="?" />
    </authorization>
    <membership defaultProvider="SqlProvider" 
      userIsOnlineTimeWindow="15">
      <providers>
        <clear/>
        <add name="SqlProvider" 
          type="System.Web.Security.SqlMembershipProvider" 
          connectionStringName="SqlServices"
          applicationName="SampleApplication"
          enablePasswordRetrieval="true"
          enablePasswordReset="true"
          passwordFormat="Encrypted"
          requiresQuestionAndAnswer="true" />
      </providers>
    </membership>

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

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </properties>
    </profile>
  </system.web>
</configuration>

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境で SqlProfileProvider クラスを使用するために必要なアクセス許可)要求値 : LinkDemand。アクセス許可値 : Minimal。

継承階層

System.Object
   System.Configuration.Provider.ProviderBase
     System.Configuration.SettingsProvider
       System.Web.Profile.ProfileProvider
        System.Web.Profile.SqlProfileProvider

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 メンバ
System.Web.Profile 名前空間
その他の技術情報
ASP.NET プロファイル プロパティ

SqlProfileProvider コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

SqlProfileProvider クラスのインスタンスを作成します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SqlProfileProvider

C#

public SqlProfileProvider ()

C++

public:
SqlProfileProvider ()

J#

public SqlProfileProvider ()

JScript

public function SqlProfileProvider ()

解説

ASP.NET は SqlProfileProvider コンストラクタを呼び出し、アプリケーションの構成ファイルで指定された値を使用して SqlProfileProvider クラスのインスタンスを作成します。このコンストラクタは、コードで使用するためのものではありません。

プラットフォーム

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 プロファイル プロパティ

SqlProfileProvider プロパティ

パブリック プロパティ

	名前	説明
	ApplicationName	オーバーライドされます。 プロファイル情報を格納および取得するアプリケーションの名前を取得または設定します。
	Description	管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 ( ProviderBase から継承されます。)
	Name	構成時にプロバイダを参照するために使用される表示名を取得します。 ( ProviderBase から継承されます。)

参照

関連項目

SqlProfileProvider クラス
System.Web.Profile 名前空間

その他の技術情報

ASP.NET プロファイル プロパティ

SqlProfileProvider メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	DeleteInactiveProfiles	オーバーライドされます。 最後のアクティビティの日付が指定した日時以前であるプロファイルの、ユーザー プロファイル データを削除します。
	DeleteProfiles	オーバーロードされます。 オーバーライドされます。 データ ソースからプロファイルのプロパティと情報を削除します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	FindInactiveProfilesByUserName	オーバーライドされます。 最後のアクティビティの日付が指定した日付またはそれ以前であり、プロファイルのユーザー名が指定した名前と一致するプロファイルのプロファイル情報を取得します。
	FindProfilesByUserName	オーバーライドされます。 指定された名前にユーザー名が一致するプロファイルのプロファイル情報を取得します。
	GetAllInactiveProfiles	オーバーライドされます。 最後のアクティビティの日付が指定した日時またはそれ以前であるプロファイルの、ユーザー プロファイル データを取得します。
	GetAllProfiles	オーバーライドされます。 データ ソース内にあるプロファイルのユーザー プロファイル データを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetNumberOfInactiveProfiles	オーバーライドされます。 データ ソース内にある、最後のアクティビティの日付が指定された userInactiveSinceDate またはそれ以前であるプロファイルの数を取得します。
	GetPropertyValues	オーバーライドされます。 SQL Server プロファイル データベースからプロファイル プロパティの情報と値を取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Initialize	オーバーライドされます。 ASP.NET アプリケーションの構成ファイルで指定されたプロパティ値を使用して SQL Server プロファイル プロバイダを初期化します。このメソッドは、コードで直接使用するためのものではありません。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetPropertyValues	オーバーライドされます。 指定されたプロパティ値で SQL Server プロファイル データベースを更新します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SqlProfileProvider クラス
System.Web.Profile 名前空間

その他の技術情報

ASP.NET プロファイル プロパティ

SqlProfileProvider メンバ

SQL Server データベース内にある ASP.NET アプリケーションに関するプロファイル情報のストレージを管理します。

SqlProfileProvider データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	SqlProfileProvider	SqlProfileProvider クラスのインスタンスを作成します。

パブリック プロパティ

	名前	説明
	ApplicationName	オーバーライドされます。 プロファイル情報を格納および取得するアプリケーションの名前を取得または設定します。
	Description	管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。(ProviderBase から継承されます。)
	Name	構成時にプロバイダを参照するために使用される表示名を取得します。(ProviderBase から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	DeleteInactiveProfiles	オーバーライドされます。 最後のアクティビティの日付が指定した日時以前であるプロファイルの、ユーザー プロファイル データを削除します。
	DeleteProfiles	オーバーロードされます。 オーバーライドされます。 データ ソースからプロファイルのプロパティと情報を削除します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	FindInactiveProfilesByUserName	オーバーライドされます。 最後のアクティビティの日付が指定した日付またはそれ以前であり、プロファイルのユーザー名が指定した名前と一致するプロファイルのプロファイル情報を取得します。
	FindProfilesByUserName	オーバーライドされます。 指定された名前にユーザー名が一致するプロファイルのプロファイル情報を取得します。
	GetAllInactiveProfiles	オーバーライドされます。 最後のアクティビティの日付が指定した日時またはそれ以前であるプロファイルの、ユーザー プロファイル データを取得します。
	GetAllProfiles	オーバーライドされます。 データ ソース内にあるプロファイルのユーザー プロファイル データを取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetNumberOfInactiveProfiles	オーバーライドされます。 データ ソース内にある、最後のアクティビティの日付が指定された userInactiveSinceDate またはそれ以前であるプロファイルの数を取得します。
	GetPropertyValues	オーバーライドされます。 SQL Server プロファイル データベースからプロファイル プロパティの情報と値を取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Initialize	オーバーライドされます。 ASP.NET アプリケーションの構成ファイルで指定されたプロパティ値を使用して SQL Server プロファイル プロバイダを初期化します。このメソッドは、コードで直接使用するためのものではありません。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetPropertyValues	オーバーライドされます。 指定されたプロパティ値で SQL Server プロファイル データベースを更新します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SqlProfileProvider クラス
System.Web.Profile 名前空間

その他の技術情報

ASP.NET プロファイル プロパティ