SqlMembershipProvider SqlMembershipProvider SqlMembershipProvider SqlMembershipProvider Class

定義

SQL Server データベース内での ASP.NET アプリケーションのメンバーシップ情報のストレージを管理します。Manages storage of membership information for an ASP.NET application in a SQL Server database.

public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider
public class SqlMembershipProvider : System.Web.Security.MembershipProvider
type SqlMembershipProvider = class
    inherit MembershipProvider
Public Class SqlMembershipProvider
Inherits MembershipProvider
継承

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

<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>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="MyApplication"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="true"  
          requiresQuestionAndAnswer="true"  
          requiresUniqueEmail="false"  
          passwordFormat="Hashed"  
          maxInvalidPasswordAttempts="5"  
          passwordAttemptWindow="10" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

注釈

このクラスを使って、MembershipMembershipUserメンバーシップ サービス、SQL Server データベースを使用して ASP.NET アプリケーションを提供するクラス。This class is used by the Membership and MembershipUser classes to provide membership services for an ASP.NET application using a SQL Server database. 使用することはできません、 SqlMembershipProvider SQL サーバーがない場合。You cannot use a SqlMembershipProvider without SQL Server. コンピューターがあり、既定のインスタンス名でインストールされている SQL Server Express ユーザー インスタンスが有効なときに、SqlMembershipProviderオブジェクトと呼ばれるデータベースが作成されますaspnetdbアプリケーションのApp_Dataディレクトリ最初のアプリケーションの時間実行されます。When your computer has SQL Server Express installed with the default instance name and user-instancing enabled, the SqlMembershipProvider object will create a database called aspnetdb in the application's App_Data directory the first time the application is run.

データベースを手動で作成するには、実行、Aspnet_regsql.exe実行可能ファイルにある、%systemroot%\Microsoft.NET\Framework\ versionNumberフォルダーを指定し、-A mオプション (たとえばaspnet_regsql.exe -A m)。To manually create the database, run the Aspnet_regsql.exe executable found in the %systemroot%\Microsoft.NET\Framework\ versionNumber folder and specify the -A m option (for example aspnet_regsql.exe -A m). 作成されたデータベースには、Aspnetdb が呼び出されます。The database created is called Aspnetdb. 代わりに、実行Aspnet_regsql.exeGUI モードの構成をプルし、すべての ASP.NET 機能の構成を選択します。Alternatively, run Aspnet_regsql.exe to pull up the GUI configuration mode and choose to configure all ASP.NET Features.

統合セキュリティを使用する接続文字列を含むメンバーシップ プロバイダーを構成する場合、ASP.NET アプリケーションのプロセス アカウントは、SQL Server データベースに接続する権限が必要です。If the membership 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.

Machine.config ファイルでは、既定値を定義します。SqlMembershipProviderという名前のインスタンスAspNetSqlMembershipProvider、ローカル コンピューターの既定の SQL Server Express インスタンスに接続します。The Machine.config file defines a default SqlMembershipProvider instance named AspNetSqlMembershipProvider that connects to the default SQL Server Express instance on the local machine. 既定のインスタンス名で SQL Server Express をインストールするか、Web.config ファイルで、独自のインスタンスを定義するには、ASP.NET アプリケーションの場合は、プロバイダーのこのインスタンスを使用できます。You can use this instance of the provider if you installed SQL Server Express with the default instance name, or you can define your own instance in the Web.config file for your ASP.NET application.

設定した場合、passwordCompatMode属性をFramework40アプリケーションが、ハッシュを使用することができ、オプションの暗号化のメンバーシップ、ASP.NET 4 で追加されました。If you set the passwordCompatMode attribute to Framework40, the application can use the hashing and encryption membership options that were added in ASP.NET 4. ただし場合、passwordCompatMode属性に設定されてFramework20ハッシュおよび暗号化のメンバーシップから ASP.NET 2.0、ASP.NET 3.5 では、オプションの、および ASP.NET 3.5 SP1 を使用することができます。However, if the passwordCompatMode attribute is set to Framework20, only the hashing and encryption membership options from the ASP.NET 2.0, ASP.NET 3.5, and ASP.NET 3.5 SP1 can be used. 既定値は Framework20 です。The default value is Framework20. 詳細については、「MembershipPasswordCompatibilityMode」を参照してください。For more information, see MembershipPasswordCompatibilityMode.

コンストラクター

SqlMembershipProvider() SqlMembershipProvider() SqlMembershipProvider() SqlMembershipProvider()

SqlMembershipProvider クラスの新しいインスタンスを初期化します。Initializes a new instance of the SqlMembershipProvider class.

プロパティ

ApplicationName ApplicationName ApplicationName ApplicationName

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

Description Description Description Description

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

(Inherited from ProviderBase)
EnablePasswordReset EnablePasswordReset EnablePasswordReset EnablePasswordReset

SQL Server メンバーシップ プロバイダーによってユーザーにパスワードのリセットが許可されているかどうかを示す値を取得します。Gets a value indicating whether the SQL Server membership provider is configured to allow users to reset their passwords.

EnablePasswordRetrieval EnablePasswordRetrieval EnablePasswordRetrieval EnablePasswordRetrieval

SQL Server メンバーシップ プロバイダーによってユーザーにパスワードの取得が許可されているかどうかを示す値を取得します。Gets a value indicating whether the SQL Server membership provider is configured to allow users to retrieve their passwords.

MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts

メンバーシップ ユーザーがロックされるまでの無効なパスワードまたはパスワード解答の指定回数を取得します。Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.

MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters

有効なパスワードに最低限含むことが必要な特殊文字の数を取得します。Gets the minimum number of special characters that must be present in a valid password.

MinRequiredPasswordLength MinRequiredPasswordLength MinRequiredPasswordLength MinRequiredPasswordLength

パスワードに最低限必要な長さを取得します。Gets the minimum length required for a password.

Name Name Name Name

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

(Inherited from ProviderBase)
PasswordAttemptWindow PasswordAttemptWindow PasswordAttemptWindow PasswordAttemptWindow

有効なパスワードまたはパスワードの解答の指定までに、連続して失敗した試行を追跡する時間枠を取得します。Gets the time window between which consecutive failed attempts to provide a valid password or password answers are tracked.

PasswordFormat PasswordFormat PasswordFormat PasswordFormat

SQL Server メンバーシップ データベースにパスワードを格納する形式を示す値を取得します。Gets a value indicating the format for storing passwords in the SQL Server membership database.

PasswordStrengthRegularExpression PasswordStrengthRegularExpression PasswordStrengthRegularExpression PasswordStrengthRegularExpression

パスワードの評価に使用される正規表現を取得します。Gets the regular expression used to evaluate a password.

RequiresQuestionAndAnswer RequiresQuestionAndAnswer RequiresQuestionAndAnswer RequiresQuestionAndAnswer

ユーザーがパスワードをリセットおよび取得する際にパスワードの質問に答えなければならないように SQL Server メンバーシップ プロバイダーが構成されているかどうかを示す値を取得します。Gets a value indicating whether the SQL Server membership provider is configured to require the user to answer a password question for password reset and retrieval.

RequiresUniqueEmail RequiresUniqueEmail RequiresUniqueEmail RequiresUniqueEmail

SQL Server メンバーシップ プロバイダーが各ユーザー名に対して一意の電子メール アドレスを要求するかどうかを示す値を取得します。Gets a value indicating whether the SQL Server membership provider is configured to require a unique email address for each user name.

メソッド

ChangePassword(String, String, String) ChangePassword(String, String, String) ChangePassword(String, String, String) ChangePassword(String, String, String)

ユーザーのパスワードを変更します。Modifies a user's password.

ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String)

SQL Server メンバーシップ データベースでユーザーのパスワードの質問と解答を更新します。Updates the password question and answer for a user in the SQL Server membership database.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

SQL Server メンバーシップ データベースに新しいユーザーを追加します。Adds a new user to the SQL Server membership database.

DecryptPassword(Byte[]) DecryptPassword(Byte[]) DecryptPassword(Byte[]) DecryptPassword(Byte[])

暗号化されたパスワードを復号化します。Decrypts an encrypted password.

(Inherited from MembershipProvider)
DeleteUser(String, Boolean) DeleteUser(String, Boolean) DeleteUser(String, Boolean) DeleteUser(String, Boolean)

SQL Server メンバーシップ データベースからユーザーのメンバーシップ情報を削除します。Removes a user's membership information from the SQL Server membership database.

EncryptPassword(Byte[]) EncryptPassword(Byte[]) EncryptPassword(Byte[]) EncryptPassword(Byte[])

パスワードを暗号化します。Encrypts a password.

(Inherited from MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

指定されたパスワード互換モードを使用して、指定されたパスワードを暗号化します。Encrypts the specified password using the specified password-compatibility mode.

(Inherited from MembershipProvider)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32)

電子メール アドレス フィールドに指定の電子メール アドレスが格納されたメンバーシップ ユーザーのコレクションを返します。Returns a collection of membership users for which the email address field contains the specified email address.

FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32)

ユーザー名が指定内容と一致するメンバーシップ ユーザーのコレクションを取得します。Gets a collection of membership users where the user name contains the specified user name to match.

GeneratePassword() GeneratePassword() GeneratePassword() GeneratePassword()

14 文字以上のランダム パスワードを生成します。Generates a random password that is at least 14 characters long.

GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32)

SQL Server メンバーシップ データベース内のすべてのユーザーのコレクションを取得します。Gets a collection of all the users in the SQL Server membership database.

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

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

(Inherited from Object)
GetNumberOfUsersOnline() GetNumberOfUsersOnline() GetNumberOfUsersOnline() GetNumberOfUsersOnline()

アプリケーションに現在アクセスしているユーザーの数を返します。Returns the number of users currently accessing the application.

GetPassword(String, String) GetPassword(String, String) GetPassword(String, String) GetPassword(String, String)

SQL Server メンバーシップ データベースから指定のユーザー名のパスワードを返します。Returns the password for the specified user name from the SQL Server membership database.

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

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

(Inherited from Object)
GetUser(Object, Boolean) GetUser(Object, Boolean) GetUser(Object, Boolean) GetUser(Object, Boolean)

データ ソースから、指定されている一意の識別子に関連付けられているメンバーシップ ユーザーの情報を取得し、指定内容に応じて、そのユーザーの最終利用日時スタンプを更新します。Gets the information from the data source for the membership user associated with the specified unique identifier and updates the last activity date/time stamp for the user, if specified.

GetUser(String, Boolean) GetUser(String, Boolean) GetUser(String, Boolean) GetUser(String, Boolean)

SQL Server メンバーシップ データベースからユーザー情報を返し、そのユーザーの最終利用日時スタンプを更新するオプションを提供します。Returns information from the SQL Server membership database for a user and provides an option to update the last activity date/time stamp for the user.

GetUserNameByEmail(String) GetUserNameByEmail(String) GetUserNameByEmail(String) GetUserNameByEmail(String)

指定した電子メール アドレスに関連付けられているユーザー名を取得します。Gets the user name associated with the specified email address.

Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

ASP.NET アプリケーションの構成ファイルに指定されているプロパティ値を使用して、SQL Server メンバーシップ プロバイダーを初期化します。Initializes the SQL Server membership 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)
OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs)

イベント ハンドラーが定義されている場合に ValidatingPassword イベントを発生させます。Raises the ValidatingPassword event if an event handler has been defined.

(Inherited from MembershipProvider)
ResetPassword(String, String) ResetPassword(String, String) ResetPassword(String, String) ResetPassword(String, String)

ユーザーのパスワードを、自動的に生成された新しいパスワードにリセットします。Resets a user's password to a new, automatically generated password.

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

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

(Inherited from Object)
UnlockUser(String) UnlockUser(String) UnlockUser(String) UnlockUser(String)

ユーザーのロック状態を解除し、メンバーシップ ユーザーを検証可能な状態にします。Clears the user's locked-out status so that the membership user can be validated.

UpdateUser(MembershipUser) UpdateUser(MembershipUser) UpdateUser(MembershipUser) UpdateUser(MembershipUser)

SQL Server メンバーシップ データベース内のユーザー情報を更新します。Updates information about a user in the SQL Server membership database.

ValidateUser(String, String) ValidateUser(String, String) ValidateUser(String, String) ValidateUser(String, String)

指定のユーザー名とパスワードが SQL Server メンバーシップ データベースに存在しているかどうかを検証します。Verifies that the specified user name and password exist in the SQL Server membership database.

イベント

ValidatingPassword ValidatingPassword ValidatingPassword ValidatingPassword

ユーザーが作成されるとき、パスワードが変更されるとき、またはパスワードがリセットされるときに発生します。Occurs when a user is created, a password is changed, or a password is reset.

(Inherited from MembershipProvider)

適用対象

こちらもご覧ください