MembershipUser.ChangePassword メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

MembershipUser.ChangePassword メソッド

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

メンバシップデータストア内のメンバシップユーザーのパスワードを更新します。

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

Visual Basic (宣言)

Public Overridable Function
 ChangePassword ( _
    oldPassword As String, _
    newPassword As String _
) As Boolean

Visual Basic (使用法)

Dim instance As MembershipUser
Dim oldPassword As String
Dim newPassword As String
Dim returnValue As Boolean

returnValue = instance.ChangePassword(oldPassword, newPassword)

public virtual bool ChangePassword (
    string oldPassword,
    string newPassword
)

C++

public:
virtual bool ChangePassword (
    String^ oldPassword, 
    String^ newPassword
)

public boolean ChangePassword (
    String oldPassword, 
    String newPassword
)

JScript

public function ChangePassword (
    oldPassword : String, 
    newPassword : String
) : boolean

パラメータ

oldPassword: メンバシップユーザーの現在のパスワード。

newPassword: メンバシップユーザーの新しいパスワード。

戻り値
更新が正常に実行された場合は true。それ以外の場合は false。

例外

例外の種類	条件
System.ArgumentException	oldPassword が空の文字列です。または newPassword が空の文字列です。
System.ArgumentNullException	oldPassword が null 参照 (Visual Basic では Nothing) です。または newPassword が null 参照 (Visual Basic では Nothing) です。

例外の種類

条件

System.ArgumentException

oldPassword が空の文字列です。

または

newPassword が空の文字列です。

System.ArgumentNullException

oldPassword が null 参照 (Visual Basic では Nothing) です。

または

newPassword が null 参照 (Visual Basic では Nothing) です。

解説

ChangePassword は、ProviderName によって参照されるメンバシッププロバイダの ChangePassword メソッドを呼び出して、メンバシップデータストア内のメンバシップユーザーのパスワードを更新します。

メンバシッププロバイダによっては、パスワードのサイズに制限があります。サイズの制限については、メンバシッププロバイダのドキュメントを参照してください。

使用例

現在ログオンしているユーザーのパスワードを変更するコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<script runat="server">

Public Sub ChangePassword_OnClick(sender As
 Object, args As EventArgs)
  ' Update the password.

  Dim u As MembershipUser = Membership.GetUser(User.Identity.Name)

  Try
    If u.ChangePassword(OldPasswordTextbox.Text, PasswordTextbox.Text)
 Then
      Msg.Text = "Password changed."
    Else
      Msg.Text = "Password change failed. Please re-enter your
 values and try again."
    End If
  Catch e As Exception
    Msg.Text = "An exception occurred: " & Server.HtmlEncode(e.Message)
 & ". Please re-enter your values and try again."
  End Try

End Sub


</script>
<html>
<head>
<title>Change Password</title>
</head>
<body>

<form runat="server">
  <h3>Change Password for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon"
 runat="server" />

  <table CellPadding="3" border="0">
    <tr>
      <td>Old Password:</td>
      <td><asp:Textbox id="OldPasswordTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="OldPasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="OldPasswordTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox"
 runat="server" TextMode="Password"
 /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ErrorMessage="Required" />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static"
 ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password
 must match password." />
      </td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="ChangePasswordButton"
 Text="Change Password" 
                      OnClick="ChangePassword_OnClick"
 runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

public void ChangePassword_OnClick(object sender,
 EventArgs args)
{
  // Update the password.

  MembershipUser u = Membership.GetUser(User.Identity.Name);

  try
  {
    if (u.ChangePassword(OldPasswordTextbox.Text, PasswordTextbox.Text))
    {
      Msg.Text = "Password changed.";
    }
    else
    {
      Msg.Text = "Password change failed. Please re-enter your values and try
 again.";
    }
  }
  catch (Exception e)
  {
    Msg.Text = "An exception occurred: " + Server.HtmlEncode(e.Message)
 + ". Please re-enter your values and try again.";
  }
}


</script>
<html>
<head>
<title>Change Password</title>
</head>
<body>

<form runat="server">
  <h3>Change Password for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server"
 />

  <table CellPadding="3" border="0">
    <tr>
      <td>Old Password:</td>
      <td><asp:Textbox id="OldPasswordTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="OldPasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="OldPasswordTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Password:</td>
      <td><asp:Textbox id="PasswordTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td>Confirm Password:</td>
      <td><asp:Textbox id="PasswordConfirmTextbox" runat="server"
 TextMode="Password" /></td>
      <td><asp:RequiredFieldValidator id="PasswordConfirmRequiredValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ErrorMessage="Required"
 />
          <asp:CompareValidator id="PasswordConfirmCompareValidator"
 runat="server"
                                      ControlToValidate="PasswordConfirmTextbox"
 ForeColor="red"
                                      Display="Static" ControlToCompare="PasswordTextBox"
                                      ErrorMessage="Confirm password must match
 password." />
      </td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="ChangePasswordButton" Text="Change
 Password" 
                      OnClick="ChangePassword_OnClick" runat="server"
 /></td>
    </tr>
  </table>
</form>

</body>
</html>

プラットフォーム

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

参照

関連項目
MembershipUser クラス
MembershipUser メンバ
System.Web.Security 名前空間
SqlMembershipProvider
その他の技術情報
メンバシップの概要

>> 「MembershipUser.ChangePassword メソッド」を含む用語の索引
MembershipUser.ChangePassword メソッドのページへのリンク


	© 2024 Microsoft.All rights reserved.

MembershipUser.ChangePassword メソッドとは？ わかりやすく解説

MembershipUser.ChangePassword メソッド

急上昇のことば

MembershipUser.ChangePassword メソッドとは？わかりやすく解説