ChangePassword.NewPassword Свойство

Определение

Возвращает новый пароль, введенный пользователем.Gets the new password entered by the user.

public:
 virtual property System::String ^ NewPassword { System::String ^ get(); };
[System.ComponentModel.Browsable(false)]
[System.Web.UI.Themeable(false)]
public virtual string NewPassword { get; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.Themeable(false)>]
member this.NewPassword : string
Public Overridable ReadOnly Property NewPassword As String

Значение свойства

String

Новый пароль, введенный пользователем.The new password entered by the user.

Атрибуты

Примеры

В следующем примере кода показано, как использовать страницу ASP.NET, которая использует ChangePassword элемент управления, и включает обработчик для ChangingPassword события с именем ChangingPassword .The following code example shows how to use an ASP.NET page that uses a ChangePassword control, and includes a handler for the ChangingPassword event named ChangingPassword. ChangingPassword сравнивает старый пароль, хранящийся в CurrentPassword свойстве, с новым паролем, хранящимся в NewPassword .ChangingPassword compares the old password stored in the CurrentPassword property to the new password stored in NewPassword. Если они совпадают, изменение пароля завершается неудачей.If they are the same, changing the password fails.

ChangePasswordЭлемент управления задает для DisplayUserName свойства значение true , чтобы разрешить пользователю вводить свое имя пользователя.The ChangePassword control sets the DisplayUserName property to true to enable the user to enter their user name. Это означает, что пользователю не нужно входить в систему для просмотра страницы.This means that the user does not have to log on to view the page.

В примере кода предполагается, что веб-сайт ASP.NET настроен для использования проверки подлинности членства и форм ASP.NET, а также что пользователь создал имя и пароль, которые вам известны.The code example assumes that the ASP.NET Web site has been configured to use ASP.NET membership and Forms authentication, and that a user has been created whose name and password are known to you. Дополнительные сведения см. в разделе Практические руководства. Реализация простой проверки подлинности с помощью форм.For more information, see How to: Implement Simple Forms Authentication.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {
    //Manually register the event-handling methods.
    ChangePassword1.ChangingPassword += new LoginCancelEventHandler(this._ChangingPassword);
  }

  void _ChangingPassword(Object sender, LoginCancelEventArgs e)
  {
    if (ChangePassword1.CurrentPassword.ToString() == ChangePassword1.NewPassword.ToString())
    {
      Message1.Visible = true;
      Message1.Text = "Old password and new password must be different.  Please try again.";
      e.Cancel = true;
    }
    else
    {
      //This line prevents the error showing up after a first failed attempt.
      Message1.Visible = false;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>ChangePassword including a ChangingPassword event handler</title>
</head>
<body>
  <form id="form1" runat="server">
  <div style="text-align:center">

    <h1>ChangePassword</h1>
    
    <asp:LoginView ID="LoginView1" Runat="server" 
      Visible="true">
      <LoggedInTemplate>
        <asp:LoginName ID="LoginName1" Runat="server" FormatString="You are logged in as {0}." />
        <br />
      </LoggedInTemplate>
      <AnonymousTemplate>
        You are not logged in
      </AnonymousTemplate>
    </asp:LoginView><br />
    
    <asp:ChangePassword ID="ChangePassword1" Runat="server"
      BorderStyle="Solid" 
      BorderWidth="1" 
      CancelDestinationPageUrl="~/Default.aspx" 
      DisplayUserName="true" 
      OnChangingPassword="_ChangingPassword"
      ContinueDestinationPageUrl="~/Default.aspx" >
    </asp:ChangePassword><br />
  
    <asp:Label ID="Message1" Runat="server" ForeColor="Red" /><br />

    <asp:HyperLink ID="HyperLink1" Runat="server" 
      NavigateUrl="~/Default.aspx">
      Home
    </asp:HyperLink>
    
  </div>
  </form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>

<!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 PageLoad(ByVal Sender As Object, ByVal e As EventArgs)
    'Manually register the event-handling methods.
    AddHandler ChangePassword1.ChangingPassword, AddressOf Me._ChangingPassword
  End Sub

  Public Sub _ChangingPassword(ByVal Sender As Object, ByVal e As LoginCancelEventArgs)
    If (ChangePassword1.CurrentPassword.ToString() = ChangePassword1.NewPassword.ToString) Then
      Message1.Visible = True
      Message1.Text = "Old password and new password must be different.  Please try again."
      e.Cancel = True
    Else
      'This line prevents the error showing up after a first failed attempt.
      Message1.Visible = False
    End If
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>ChangePassword including a ChangingPassword event handler</title>
</head>
<body>
  <form id="form1" runat="server">
  <div style="text-align:center">

    <h1>ChangePassword</h1>
    
    <asp:LoginView ID="LoginView1" Runat="server" 
      Visible="true">
      <LoggedInTemplate>
        <asp:LoginName ID="LoginName1" Runat="server" FormatString="You are logged in as {0}." />
        <br />
      </LoggedInTemplate>
      <AnonymousTemplate>
        You are not logged in
      </AnonymousTemplate>
    </asp:LoginView><br />
    
    <asp:ChangePassword ID="ChangePassword1" Runat="server"
      BorderStyle="Solid" 
      BorderWidth="1" 
      CancelDestinationPageUrl="~/Default.aspx" 
      DisplayUserName="true" 
      OnChangingPassword="_ChangingPassword"
      ContinueDestinationPageUrl="~/Default.aspx" >
    </asp:ChangePassword><br />
  
    <asp:Label ID="Message1" Runat="server" ForeColor="Red" /><br />

    <asp:HyperLink ID="HyperLink1" Runat="server" 
      NavigateUrl="~/Default.aspx">
      Home
    </asp:HyperLink>
    
  </div>
  </form>
</body>
</html>

Комментарии

NewPasswordСвойство содержит новый пароль, введенный пользователем.The NewPassword property contains the new password entered by the user.

Для NewPasswordRegularExpression определения требований к новому паролю можно использовать свойство.You can use the NewPasswordRegularExpression property to define the requirements for the new password. Это регулярное выражение используется для применения правил паролей на стороне клиента.This regular expression is used to enforce password rules on the client side. NewPasswordRegularExpressionНе относится к принудительному применению пароля, который можно настроить на уровне хранилища данных.The NewPasswordRegularExpression is not related to the password enforcement that can be configured at the data store level. Пароль должен соответствовать минимальным требованиям, заданным поставщиком членства в MinRequiredPasswordLength MinRequiredNonAlphanumericCharacters PasswordStrengthRegularExpression свойствах, и.The password must meet the minimum requirements set by the membership provider in the MinRequiredPasswordLength, MinRequiredNonAlphanumericCharacters, and PasswordStrengthRegularExpression properties. Если пароль не соответствует этим требованиям, ChangePasswordError возникает событие.If the password does not meet these requirements, the ChangePasswordError event is raised.

Важно!

Передача паролей по протоколу HTTP является потенциальной угрозой безопасности.Transmitting passwords over HTTP is a potential security threat. Передачи данных по протоколу HTTP могут быть просмотрены или взломаны злоумышленниками.HTTP transmissions can be viewed or compromised by malicious users. Для повышения безопасности при использовании элементов управления входа следует использовать протокол HTTPS с шифрованием по протоколу SSL, чтобы гарантировать, что пароль пользователя не может быть прочитан во время обратной передачи.To improve security when using login controls, you should use HTTPS protocol with secure sockets layer (SSL) encryption to ensure that the user's password cannot be read during postback. Дополнительные сведения см. в разделе Защита элементов управления входом.For more information, see Securing Login Controls.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см. в статьях ThemeableAttribute и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Применяется к

См. также раздел