ChangePassword.NewPassword Özellik

Tanım

Kullanıcı tarafından girilen yeni parolayı alır.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

Özellik Değeri

String

Kullanıcı tarafından girilen yeni parola.The new password entered by the user.

Öznitelikler

Örnekler

Aşağıdaki kod örneği, bir denetimi kullanan bir ASP.NET sayfasının nasıl kullanılacağını gösterir ChangePassword ve adlı olay için bir işleyici içerir 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 özelliğindeki eski parolayı, CurrentPassword içinde depolanan yeni parolayla karşılaştırır NewPassword .ChangingPassword compares the old password stored in the CurrentPassword property to the new password stored in NewPassword. Bunlar aynıysa, parola değiştirme başarısız olur.If they are the same, changing the password fails.

ChangePasswordDenetim, DisplayUserName true kullanıcının Kullanıcı adını girmesini sağlamak için özelliğini olarak ayarlar.The ChangePassword control sets the DisplayUserName property to true to enable the user to enter their user name. Bu, kullanıcının sayfayı görüntülemek için oturum açması gerekmediği anlamına gelir.This means that the user does not have to log on to view the page.

Kod örneği, ASP.NET Web sitesinin ASP.NET üyeliğini ve Forms kimlik doğrulamasını kullanacak şekilde yapılandırıldığını ve adı ve parolasının sizin tarafından bilinildiği bir kullanıcının oluşturulduğunu varsayar.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. Daha fazla bilgi için bkz. nasıl yapılır: basit form kimlik doğrulaması uygulama.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>

Açıklamalar

NewPasswordÖzelliği, Kullanıcı tarafından girilen yeni parolayı içerir.The NewPassword property contains the new password entered by the user.

NewPasswordRegularExpressionYeni parola gereksinimlerini tanımlamak için özelliğini kullanabilirsiniz.You can use the NewPasswordRegularExpression property to define the requirements for the new password. Bu normal ifade, istemci tarafında parola kurallarını zorlamak için kullanılır.This regular expression is used to enforce password rules on the client side. , NewPasswordRegularExpression Veri deposu düzeyinde yapılandırılabilecek parola zorlaması ile ilgili değildir.The NewPasswordRegularExpression is not related to the password enforcement that can be configured at the data store level. Parolanın,, ve özelliklerindeki Üyelik sağlayıcısı tarafından ayarlanan minimum gereksinimleri karşılaması gerekir MinRequiredPasswordLength MinRequiredNonAlphanumericCharacters PasswordStrengthRegularExpression .The password must meet the minimum requirements set by the membership provider in the MinRequiredPasswordLength, MinRequiredNonAlphanumericCharacters, and PasswordStrengthRegularExpression properties. Parola bu gereksinimleri karşılamıyorsa, ChangePasswordError olay tetiklenir.If the password does not meet these requirements, the ChangePasswordError event is raised.

Önemli

Parolaların HTTP üzerinden iletilmesi olası bir güvenlik tehditlidir.Transmitting passwords over HTTP is a potential security threat. HTTP iletimleri kötü amaçlı kullanıcılar tarafından görüntülenebilir veya tehlikeye girebilir.HTTP transmissions can be viewed or compromised by malicious users. Oturum açma denetimlerini kullanırken güvenliği artırmak için, kullanıcının parolasının geri gönderme sırasında okunamaz olduğundan emin olmak için Güvenli Yuva Katmanı (SSL) şifrelemesi ile HTTPS protokolünü kullanmanız gerekir.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. Daha fazla bilgi için bkz. oturum açma denetimlerini güvenli hale getirme.For more information, see Securing Login Controls.

Bu özellik Temalar veya stil sayfası temaları tarafından ayarlanamaz.This property cannot be set by themes or style sheet themes. Daha fazla bilgi için bkz ThemeableAttribute . ve ASP.net Temalar ve kaplamalar.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Şunlara uygulanır

Ayrıca bkz.