SqlMembershipProvider.ResetPassword(String, String) 方法

參考

定義

命名空間:: System.Web.Security

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將使用者的密碼重設為自動產生的新密碼。

public:
 override System::String ^ ResetPassword(System::String ^ username, System::String ^ passwordAnswer);

public override string ResetPassword (string username, string passwordAnswer);

override this.ResetPassword : string * string -> string

Public Overrides Function ResetPassword (username As String, passwordAnswer As String) As String

參數

username: String

要為其重設密碼的使用者。

passwordAnswer: String

指定之使用者的密碼回應。

傳回

String

指定之使用者的新密碼。

例外狀況

MembershipPasswordException

passwordAnswer 無效。

-或-

目前已鎖定的使用者帳戶。

NotSupportedException

EnablePasswordReset 設定為 false。

ProviderException

username 在成員資格資料庫中找不到。

-或-

變更密碼的動作是由 ValidatingPassword 事件的訂閱者取消，且 FailureInformation 屬性為 null。

-或-

從資料庫擷取密碼時發生錯誤。

ArgumentException

username 為空字串 ("")、包含逗號或超過 256 個字元。

-或-

passwordAnswer 是空字串或長度超過 128 個字元，而且 RequiresQuestionAndAnswer 為 true。

-或-

編碼以後，passwordAnswer 長於 128 個字元。

ArgumentNullException

username 為 null。

-或-

passwordAnswer 是 null，而 RequiresQuestionAndAnswer 是 true。

Exception

發生未處理的例外狀況。

範例

下列程式代碼範例會重設用戶的密碼，並傳回新的自動產生密碼。

注意

這個範例會使用類別 Membership 呼叫 SqlMembershipProvider 指定的，做為 defaultProvider Web.config 檔案中的。如果您需要存取預設提供者做為類型 SqlMembershipProvider，您可以轉換 Provider 類別的 Membership 屬性。若要以特定提供者類型的形式存取其他已設定的提供者，您可以使用類別 Providers 的 Membership 屬性來存取這些提供者，並將其轉換成特定提供者類型。

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

public void Page_Load(object sender, EventArgs args)
{
  if (!Membership.EnablePasswordReset)
  {
    FormsAuthentication.RedirectToLoginPage();
  }

  Msg.Text = "";

  if (!IsPostBack)
  {
    Msg.Text = "Please enter a user name.";
  }
  else
  {
    VerifyUsername();
  }
}


public void VerifyUsername()
{
    MembershipUser user = Membership.GetUser(UsernameTextBox.Text, false);

    if (user == null)
    {
      Msg.Text = "The user name " + Server.HtmlEncode(UsernameTextBox.Text) + " was not found. Please check the value and reenter your user name.";

      QuestionLabel.Text = "";
      QuestionLabel.Enabled = false;
      AnswerTextBox.Enabled = false;
      ResetPasswordButton.Enabled = false;
    }
    else
    {
      QuestionLabel.Text = user.PasswordQuestion;
      QuestionLabel.Enabled = true;
      AnswerTextBox.Enabled = true;
      ResetPasswordButton.Enabled = true;
    }
}

public void ResetPassword_OnClick(object sender, EventArgs args)
{
  string newPassword = "";

  try
  {
    newPassword = Membership.Provider.ResetPassword(UsernameTextBox.Text, AnswerTextBox.Text);
  }
  catch (NotSupportedException e)
  {
    Msg.Text = "An error has occurred resetting your password: " + e.Message + "." +
               "Please check your values and try again.";
  }
  catch (MembershipPasswordException e)
  {
    Msg.Text = "Invalid password answer. Please reenter the answer and try again.";
    return;
  }
  catch (System.Configuration.Provider.ProviderException e)
  {
    Msg.Text = "The specified user name does not exist. Please check your value and try again.";
  }

  if (newPassword != "")
  {
    Msg.Text = "Password reset. Your new password is: " + Server.HtmlEncode(newPassword);
  }
  else
  {
    Msg.Text = "Password reset failed. Please reenter your values and try again.";
  }
}


</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Reset Password</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Reset Password</h3>

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

  Username: <asp:Textbox id="UsernameTextBox" Columns="30" runat="server" AutoPostBack="true" />
            <asp:RequiredFieldValidator id="UsernameRequiredValidator" runat="server"
                                        ControlToValidate="UsernameTextBox" ForeColor="red"
                                        Display="Static" ErrorMessage="Required" /><br />

  Password Question: <b><asp:Label id="QuestionLabel" runat="server" /></b><br />

  Answer: <asp:TextBox id="AnswerTextBox" Columns="60" runat="server" Enabled="false" />
          <asp:RequiredFieldValidator id="AnswerRequiredValidator" runat="server"
                                      ControlToValidate="AnswerTextBox" ForeColor="red"
                                      Display="Static" ErrorMessage="Required" Enabled="false" /><br />

  <asp:Button id="ResetPasswordButton" Text="Reset Password" 
              OnClick="ResetPassword_OnClick" runat="server" Enabled="false" />

</form>

</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Public Sub Page_Load(sender As Object, args As EventArgs)

  If Not Membership.EnablePasswordReset Then
    FormsAuthentication.RedirectToLoginPage()
  End If

  Msg.Text = ""

  If Not IsPostBack Then
    Msg.Text = "Please enter a user name."
  Else
    VerifyUsername()
  End If

End Sub


Public Sub VerifyUsername()

    Dim user As MembershipUser = Membership.GetUser(UsernameTextBox.Text, False)

    If user Is Nothing Then
      Msg.Text = "The user name " & Server.HtmlEncode(UsernameTextBox.Text) & " was not found. Please check the value and reenter your user name."

      QuestionLabel.Text = ""
      QuestionLabel.Enabled = False
      AnswerTextBox.Enabled = False
      ResetPasswordButton.Enabled = False
    Else
      QuestionLabel.Text = user.PasswordQuestion
      QuestionLabel.Enabled = True
      AnswerTextBox.Enabled = True
      ResetPasswordButton.Enabled = True
    End If

End Sub


Public Sub ResetPassword_OnClick(sender As Object, args As EventArgs)

  Dim newPassword As String = ""

  Try
    newPassword = Membership.Provider.ResetPassword(UsernameTextBox.Text, AnswerTextBox.Text)
  Catch e As NotSupportedException
    Msg.Text = "An error has occurred resetting your password: " & e.Message & "." & _
               "Please check your values and try again."
  Catch e As MembershipPasswordException
    Msg.Text = "Invalid password answer. Please reenter the answer and try again."
    Return
  Catch e As System.Configuration.Provider.ProviderException
    Msg.Text = "The specified user name does not exist. Please check your value and try again."
  End Try

  If newPassword <> "" Then
    Msg.Text = "Password reset. Your new password is: " & Server.HtmlEncode(newPassword)
  Else
    Msg.Text = "Password reset failed. Please reenter your values and try again."
  End If

End Sub


</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Reset Password</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Reset Password</h3>

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

  Username: <asp:Textbox id="UsernameTextBox" Columns="30" runat="server" AutoPostBack="True" />
            <asp:RequiredFieldValidator id="UsernameRequiredValidator" runat="server"
                                        ControlToValidate="UsernameTextBox" ForeColor="red"
                                        Display="Static" ErrorMessage="Required" /><br />

  Password Question: <b><asp:Label id="QuestionLabel" runat="server" /></b><br />

  Answer: <asp:TextBox id="AnswerTextBox" Columns="60" runat="server" Enabled="False" />
          <asp:RequiredFieldValidator id="AnswerRequiredValidator" runat="server"
                                      ControlToValidate="AnswerTextBox" ForeColor="red"
                                      Display="Static" ErrorMessage="Required" Enabled="False" /><br />

  <asp:Button id="ResetPasswordButton" Text="Reset Password" 
              OnClick="ResetPassword_OnClick" runat="server" Enabled="False" />

</form>

</body>
</html>

備註

類別會呼叫 Membership 這個方法，以將 ASP.NET 應用程式組態檔中指定的 SQL Server 資料庫中使用者的密碼 (Web.config) 重設為新的隨機產生的新值。傳回新的密碼。

注意

方法所建立的 ResetPassword 隨機密碼不保證會在屬性中 PasswordStrengthRegularExpression 傳遞正則表示式。不過，隨機密碼將符合和 MinRequiredNonAlphanumericCharacters 屬性所建立的MinRequiredPasswordLength準則。

當屬性ResetPassword設定為 Hashed時PasswordFormat，最常使用方法。如果用戶忘記哈希的密碼，就無法擷取密碼。不過，如果使用者提供正確的密碼答案，提供者可以將密碼重設為新的自動產生密碼。

如果提供不正確的密碼答案給 ResetPassword 方法，追蹤無效密碼嘗試的內部計數器會遞增一。這可能會導致使用者遭到鎖定，且無法登入，直到呼叫 UnlockUser 方法清除鎖定狀態為止。如果提供正確的密碼答案，且使用者目前未鎖定，則追蹤無效密碼回應嘗試的內部計數器會重設為零。如需詳細資訊，請參閱 MaxInvalidPasswordAttempts 和 PasswordAttemptWindow 屬性。

您可以先從 Provider 類別的屬性取得實例的Membership參考SqlMembershipProvider，直接呼叫 ResetPassword 方法。產生的密碼長度至少為14個字元，或屬性中指定的 MinRequiredPasswordLength 長度，且會包含屬性中指定的 MinRequiredNonAlphanumericCharacters 非英數位元數目。如果指定了正則表示式，則不保證密碼會傳遞屬性中包含的 PasswordStrengthRegularExpression 正則表示式。

前置和尾端空格會從所有參數值修剪。

適用於

另請參閱

ASP.NET 成員資格簡介

共用方式為

SqlMembershipProvider.ResetPassword(String, String) 方法

定義

參數

傳回

例外狀況

範例

備註

適用於

另請參閱

其他資源