SqlMembershipProvider クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
- 継承
例
次のコード例は、 を使用するように構成された 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 メンバーシップ データベースに存在しているかどうかを検証します。 |
events
ValidatingPassword |
ユーザーが作成されるとき、パスワードが変更されるとき、またはリセットされるときに発生します。 (継承元 MembershipProvider) |