SqlMembershipProvider クラス

定義

SQL Server データベース内での ASP.NET アプリケーションのメンバーシップ情報のストレージを管理します。

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
継承
SqlMembershipProvider

次のコード例は、 を使用するように構成された ASP.NET アプリケーションの Web.config ファイルを 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>  

注釈

注意

ASP.NET メンバーシップ プロバイダーは 、ASP.NET ID によって置き換えられます。 メンバーシップ プロバイダーではなく、ASP.NET ID プラットフォームを使用するようにアプリを更新することを強くお勧めします。

このクラスは、 クラスと MembershipUser クラスによって使用されMembership、SQL Server データベースを使用して ASP.NET アプリケーションのメンバーシップ サービスを提供します。 SQL Server を使用しない 場合は、 を SqlMembershipProvider 使用できません。 既定のインスタンス名とユーザーインスタンス化が有効になっている SQL Server Express がコンピューターにインストールされている場合、SqlMembershipProviderオブジェクトはアプリケーションの初回実行時に、アプリケーションのApp_Dataディレクトリに というaspnetdbデータベースを作成します。

データベースを手動で作成するには、 フォルダーにある実行可能ファイルをAspnet_regsql.exe%systemroot%\Microsoft.NET\Framework\ versionNumber実行し、 オプションを-A m指定します (例: aspnet_regsql.exe -A m)。 作成されたデータベースは Aspnetdb と呼ばれます。 または、 を実行 Aspnet_regsql.exe して GUI 構成モードをプルし、すべての ASP.NET 機能の構成を選択します。

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

Machine.config ファイルは、 という名前AspNetSqlMembershipProviderの既定SqlMembershipProviderのインスタンスを定義し、ローカル コンピューター上の既定の SQL Server Express インスタンスに接続します。 既定のインスタンス名で SQL Server Express をインストールした場合は、プロバイダーのこのインスタンスを使用するか、ASP.NET アプリケーションの Web.config ファイルに独自のインスタンスを定義できます。

属性を passwordCompatModeFramework40設定した場合、アプリケーションでは、ASP.NET 4 で追加されたハッシュと暗号化のメンバーシップ オプションを使用できます。 ただし、 属性が passwordCompatModeFramework20設定されている場合は、ASP.NET 2.0、ASP.NET 3.5、ASP.NET 3.5 SP1 からのハッシュと暗号化のメンバーシップ オプションのみを使用できます。 既定値は Framework20 です。 詳細については、「MembershipPasswordCompatibilityMode」を参照してください。

コンストラクター

SqlMembershipProvider()

SqlMembershipProvider クラスの新しいインスタンスを初期化します。

プロパティ

ApplicationName

メンバーシップ情報を格納および取得するアプリケーションの名前を取得または設定します。

Description

管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。

(継承元 ProviderBase)
EnablePasswordReset

SQL Server メンバーシップ プロバイダーによってユーザーにパスワードのリセットが許可されているかどうかを示す値を取得します。

EnablePasswordRetrieval

SQL Server メンバーシップ プロバイダーによってユーザーにパスワードの取得が許可されているかどうかを示す値を取得します。

MaxInvalidPasswordAttempts

メンバーシップ ユーザーがロック アウトされるまでの無効なパスワードまたはパスワード解答の試行回数を取得します。

MinRequiredNonAlphanumericCharacters

有効なパスワードに存在する必要がある特殊文字の最小数を取得します。

MinRequiredPasswordLength

パスワードに最低限必要な長さを取得します。

Name

構成時にプロバイダーを参照するために使用される表示名を取得します。

(継承元 ProviderBase)
PasswordAttemptWindow

有効なパスワードまたはパスワードの解答の指定までに、連続して失敗した試行を追跡する時間枠を取得します。

PasswordFormat

SQL Server メンバーシップ データベースにパスワードを格納する形式を示す値を取得します。

PasswordStrengthRegularExpression

パスワードの評価に使用される正規表現を取得します。

RequiresQuestionAndAnswer

ユーザーがパスワードをリセットおよび取得する際にパスワードの質問に答えなければならないように SQL Server メンバーシップ プロバイダーが構成されているかどうかを示す値を取得します。

RequiresUniqueEmail

SQL Server メンバーシップ プロバイダーが各ユーザー名に対して一意の電子メール アドレスを要求するかどうかを示す値を取得します。

メソッド

ChangePassword(String, String, String)

ユーザーのパスワードを変更します。

ChangePasswordQuestionAndAnswer(String, String, String, String)

SQL Server メンバーシップ データベースでユーザーのパスワードの質問と解答を更新します。

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

SQL Server メンバーシップ データベースに新しいユーザーを追加します。

DecryptPassword(Byte[])

暗号化されたパスワードの暗号化を解除します。

(継承元 MembershipProvider)
DeleteUser(String, Boolean)

SQL Server メンバーシップ データベースからユーザーのメンバーシップ情報を削除します。

EncryptPassword(Byte[])

パスワードを暗号化します。

(継承元 MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

指定されたパスワード互換モードを使用して、指定されたパスワードを暗号化します。

(継承元 MembershipProvider)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
FindUsersByEmail(String, Int32, Int32, Int32)

電子メール アドレス フィールドに指定の電子メール アドレスが格納されたメンバーシップ ユーザーのコレクションを返します。

FindUsersByName(String, Int32, Int32, Int32)

ユーザー名が指定内容と一致するメンバーシップ ユーザーのコレクションを取得します。

GeneratePassword()

14 文字以上のランダム パスワードを生成します。

GetAllUsers(Int32, Int32, Int32)

SQL Server メンバーシップ データベース内のすべてのユーザーのコレクションを取得します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetNumberOfUsersOnline()

アプリケーションに現在アクセスしているユーザーの数を返します。

GetPassword(String, String)

SQL Server メンバーシップ データベースから指定のユーザー名のパスワードを返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetUser(Object, Boolean)

データ ソースから、指定されている一意の識別子に関連付けられているメンバーシップ ユーザーの情報を取得し、指定内容に応じて、そのユーザーの最終利用日時スタンプを更新します。

GetUser(String, Boolean)

SQL Server メンバーシップ データベースからユーザー情報を返し、そのユーザーの最終利用日時スタンプを更新するオプションを提供します。

GetUserNameByEmail(String)

指定した電子メール アドレスに関連付けられているユーザー名を取得します。

Initialize(String, NameValueCollection)

ASP.NET アプリケーションの構成ファイルに指定されているプロパティ値を使用して、SQL Server メンバーシップ プロバイダーを初期化します。 このメソッドはコードから直接使用するためのものではありません。

MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnValidatingPassword(ValidatePasswordEventArgs)

イベント ハンドラーが定義されている場合に ValidatingPassword イベントを発生させます。

(継承元 MembershipProvider)
ResetPassword(String, String)

ユーザーのパスワードをリセットして、自動的に生成された新しいパスワードにします。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
UnlockUser(String)

ユーザーのロック状態を解除し、メンバーシップ ユーザーを検証可能な状態にします。

UpdateUser(MembershipUser)

SQL Server メンバーシップ データベース内のユーザー情報を更新します。

ValidateUser(String, String)

指定のユーザー名とパスワードが SQL Server メンバーシップ データベースに存在しているかどうかを検証します。

イベント

ValidatingPassword

ユーザーが作成されるとき、パスワードが変更されるとき、またはリセットされるときに発生します。

(継承元 MembershipProvider)

適用対象

こちらもご覧ください