SqlProfileProvider SqlProfileProvider SqlProfileProvider SqlProfileProvider Class

定義

SQL Server データベース内にある ASP.NET アプリケーションに関するプロファイル情報のストレージを管理します。Manages storage of profile information for an ASP.NET application in a SQL Server database.

public ref class SqlProfileProvider : System::Web::Profile::ProfileProvider
public class SqlProfileProvider : System.Web.Profile.ProfileProvider
type SqlProfileProvider = class
    inherit ProfileProvider
Public Class SqlProfileProvider
Inherits ProfileProvider
継承

を使用SqlProfileProviderするように構成された ASP.NET アプリケーションの web.config ファイルのコード例を次に示します。The following code example shows the Web.config file for an ASP.NET application configured to use a SqlProfileProvider.

<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>  

注釈

ASP.NET プロファイルは、データベースなどのデータソースのユーザー設定を格納および取得するために使用されます。The ASP.NET profile is used to store and retrieve user settings in a data source such as a database. ユーザープロファイルには、現在Profile HttpContextののプロパティを使用してアクセスします。The user profile is accessed using the Profile property of the current HttpContext. プロファイル情報とプロパティ値は、プロファイルプロバイダーを使用して管理されます。Profile information and property values are managed using a profile provider.

SqlProfileProviderクラスは、SQL Server データベースを使用している ASP.NET アプリケーションのプロファイル設定を格納および取得するために ASP.NET によって使用されます。The SqlProfileProvider class is used by ASP.NET to store and retrieve profile settings for an ASP.NET application that is using a SQL Server database. を使用SqlProfileProviderするには、まずにSqlProfileProviderよって使用される SQL Server データベースを作成する必要があります。To use a SqlProfileProvider, you must first create the SQL Server database used by the SqlProfileProvider. によっSqlProfileProviderて使用されるデータベースを作成するには、aspnet_regsql.exe ツールを実行します。この** ツールは [drive\ :] \windows\ microsoft.net \framework2.0versionNumberフォルダーにあり、 -A pオプションを指定します。To create the database used by the SqlProfileProvider, run the aspnet_regsql.exe tool, which is found in the [drive:]\WINDOWS\Microsoft.NET\Framework\2.0versionNumber folder, and specify the -A p option. 次のコマンドは、aspnet_regsql.exe 実行可能ファイルの使用方法を示しています。The following command demonstrates how you might use the aspnet_regsql.exe executable:

aspnet_regsql.exe -A p  

上の例では、作成されるデータベースの名前を指定していないため、既定の名前が使用されます。The example above does not specify a name for the database that is created, so the default name will be used. 既定のデータベース名は Aspnetdb.mdf です。The default database name is Aspnetdb.

マシン構成には、ローカルSqlProfileProviderコンピューター上の SQL Server に接続する、AspNetSqlProvider という名前の既定のインスタンスが含まれています。The machine configuration contains a default SqlProfileProvider instance named AspNetSqlProvider that connects to the SQL Server on the local machine. このプロバイダーのインスタンスを使用することも、ASP.NET アプリケーションの web.config ファイルで独自のインスタンスを指定することもできます。You can use this instance of the provider, or specify your own in the Web.config file for your ASP.NET application.

注意

プロファイルプロバイダーが統合セキュリティを使用する接続文字列を使用して構成されている場合、ASP.NET アプリケーションのプロセスアカウントは、SQL Server データベースに接続する権限を持っている必要があります。If the profile provider is configured with a connection string that uses integrated security, the process account of the ASP.NET application must have rights to connect to the SQL Server database.

コンストラクター

SqlProfileProvider() SqlProfileProvider() SqlProfileProvider() SqlProfileProvider()

SqlProfileProvider クラスのインスタンスを作成します。Creates an instance of the SqlProfileProvider class.

プロパティ

ApplicationName ApplicationName ApplicationName ApplicationName

プロファイル情報を格納および取得するアプリケーションの名前を取得または設定します。Gets or sets the name of the application for which to store and retrieve profile information.

Description Description Description Description

管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
Name Name Name Name

構成時にプロバイダーを参照するために使用される表示名を取得します。Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)

メソッド

DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime) DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime) DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime) DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)

最後のアクティビティの日付が指定した日時以前であるプロファイルの、ユーザー プロファイル データを削除します。Deletes user profile data for profiles in which the last activity date occurred before the specified date and time.

DeleteProfiles(ProfileInfoCollection) DeleteProfiles(ProfileInfoCollection) DeleteProfiles(ProfileInfoCollection) DeleteProfiles(ProfileInfoCollection)

指定されたプロファイル リストに該当するプロファイルのプロパティと情報をデータ ソースから削除します。Deletes profile properties and information for the supplied list of profiles from the data source.

DeleteProfiles(String[]) DeleteProfiles(String[]) DeleteProfiles(String[]) DeleteProfiles(String[])

指定されたユーザー名リストに該当するプロファイルのプロパティと情報をデータ ソースから削除します。Deletes profile properties and information from the data source for the supplied list of user names.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32) FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32) FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32) FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)

最後のアクティビティの日付が指定した日付またはそれ以前であり、プロファイルのユーザー名が指定した名前と一致するプロファイルのプロファイル情報を取得します。Retrieves profile information for profiles in which the last activity date occurred on or before the specified date and time and the user name for the profile matches the specified name.

FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32) FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32) FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32) FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)

指定された名前にユーザー名が一致するプロファイルのプロファイル情報を取得します。Retrieves profile information for profiles in which the user name matches the specified name.

GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32) GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32) GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32) GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)

最後のアクティビティの日付が指定した日時またはそれ以前であるプロファイルの、ユーザー プロファイル データを取得します。Retrieves user profile data for profiles in which the last activity date occurred on or before the specified date and time.

GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32) GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32) GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32) GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)

データ ソース内にあるプロファイルのユーザー プロファイル データを取得します。Retrieves user profile data for profiles in the data source.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime) GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime) GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime) GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)

データ ソース内にある、最後のアクティビティの日付が指定された userInactiveSinceDate またはそれ以前であるプロファイルの数を取得します。Gets the number of profiles in the data source where the last activity date occurred on or before the specified userInactiveSinceDate.

GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection) GetPropertyValues(SettingsContext, SettingsPropertyCollection)

SQL Server プロファイル データベースからプロファイル プロパティの情報と値を取得します。Retrieves profile property information and values from a SQL Server profile database.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

ASP.NET アプリケーションの構成ファイルで指定されたプロパティ値を使用して SQL Server プロファイル プロバイダーを初期化します。Initializes the SQL Server profile provider with the property values specified in the ASP.NET application's configuration file. このメソッドはコードから直接使用するためのものではありません。This method is not intended to be used directly from your code.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection) SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

指定されたプロパティ値で SQL Server プロファイル データベースを更新します。Updates the SQL Server profile database with the specified property values.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください