MembershipProvider.ResetPassword メソッド

.NET Framework クラス ライブラリ リファレンス

MembershipProvider.ResetPassword メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 ResetPassword ( _
    username As String, _
    answer As String _
) As String

Visual Basic (使用法)

Dim instance As MembershipProvider
Dim username As String
Dim answer As String
Dim returnValue As String

returnValue = instance.ResetPassword(username, answer)

C#

public abstract string ResetPassword (
    string username,
    string answer
)

C++

public:
virtual String^ ResetPassword (
    String^ username, 
    String^ answer
) abstract

J#

public abstract String ResetPassword (
    String username, 
    String answer
)

JScript

public abstract function ResetPassword (
    username : String, 
    answer : String
) : String

パラメータ

username

パスワードをリセットするユーザー。

answer

指定したユーザーのパスワードの解答。

戻り値
指定したユーザーの新しいパスワード。

解説

ユーザー名とパスワードの解答を入力値として受け取り、指定したユーザーに対して新しいランダム パスワードを生成します。

メモ
ResetPassword メソッドにより生成されたランダム パスワードは、PasswordStrengthRegularExpression プロパティの正規表現に合格するとは限りません。ただし、ランダム パスワードは、MinRequiredPasswordLength プロパティおよび MinRequiredNonAlphanumericCharacters プロパティで設定された基準は満たしています。

ResetPassword メソッドは、データ ソース内のユーザー情報を新しいパスワード値で更新し、新しいパスワードを文字列として返します。ランダム パスワードは GeneratePassword メソッドにより生成されます。

ResetPassword メソッドは、まず EnablePasswordReset フラグが true であることを確認します。EnablePasswordReset が false の場合、NotSupportedException 例外がスローされます。

ResetPassword は、RequiresQuestionAndAnswer プロパティの値もチェックします。RequiresQuestionAndAnswer が true の場合、ResetPassword は、データ ソースに格納されているパスワードの解答と、入力された解答パラメータ値を比較します。これらが一致しない場合、MembershipPasswordException 例外がスローされます。

使用例

MembershipProvider 実装の例については、「プロファイル プロバイダの実装」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MembershipProvider クラス
MembershipProvider メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップ プロバイダの実装
メンバシップの概要