ChangePassword

このメソッドは、ユーザーのパスワードを更新します。

宣言

// C#
public override bool ChangePassword(string userName, string oldPassword, 
  string 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を戻します。