2.1.5.1 ChangePassword
このメソッドは、ユーザーのパスワードを更新します。
宣言
// C# public override bool ChangePassword(string userName, string oldPassword, string newPassword);
パラメータ
-
userName
パスワードを更新する対象のユーザー。
-
oldPassword
指定されたユーザーの現在のパスワード。
-
newPassword
指定されたユーザーの新しいパスワード。
戻り値
パスワードが正常に更新された場合はtrue
を戻し、それ以外の場合はfalse
を戻します。
例外
ArgumentNullException
- userName
、oldPassword
またはnewPassword
パラメータがnullです。
System.Web.Security.MembershipPasswordException
- userName
がメンバーシップ・データベースに見つかりませんでした。
System.Configuration.Provider.ProviderException
- データベースに新しいパスワードを設定しているときにエラーが発生しました。
例外
- 処理されない例外が発生しました。
ArgumentException
- 次のいずれかの条件が存在します。
-
userName
パラメータが空の文字列であるか、カンマが含まれているか、256文字を超えています。 -
oldPassword
パラメータが空の文字列であるか、128文字を超えています。 -
newPassword
パラメータが、空の文字列である、128文字(エンコードされたバージョンを含む)より長い、MinRequiredPasswordLength
プロパティの値より小さい、英数字文字以外の文字数がMinRequiredNonAlphanumericCharacters
プロパティの値より少ない、PasswordStrengthRegularExpression
プロパティで定義された正規表現と一致しない、のいずれかです。 -
パスワード変更操作が
ValidatingPassword
イベントのサブスクライバによって取り消され、FailureInformation
プロパティがnull参照でした。
備考
ChangePassword
メソッドは、指定されたユーザー名とパスワードが有効で、パスワードが正しく更新された場合にtrue
を戻します。それ以外の場合はfalse
を戻します。