SqlMembershipProvider クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

継承: Object

ProviderBase

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 ファイルに独自のインスタンスを定義できます。

属性を passwordCompatMode に Framework40設定した場合、アプリケーションでは、ASP.NET 4 で追加されたハッシュと暗号化のメンバーシップオプションを使用できます。ただし、属性が passwordCompatMode に Framework20設定されている場合は、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)

適用対象

こちらもご覧ください

ASP.NET メンバーシップの概要