Deklarative Syntax des ChangePassword-Webserver-Steuerelements

Aktualisiert: November 2007

Erstellt eine Benutzeroberfläche, mit der Benutzer ihr Kennwort für die Website ändern können.

<asp:ChangePassword
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderPadding="integer"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CancelButtonImageUrl="uri"
    CancelButtonText="string"
    CancelButtonType="Button|Image|Link"
    CancelDestinationPageUrl="uri"
    ChangePasswordButtonImageUrl="uri"
    ChangePasswordButtonText="string"
    ChangePasswordButtonType="Button|Image|Link"
    ChangePasswordFailureText="string"
    ChangePasswordTitleText="string"
    ConfirmNewPasswordLabelText="string"
    ConfirmPasswordCompareErrorMessage="string"
    ConfirmPasswordRequiredErrorMessage="string"
    ContinueButtonImageUrl="uri"
    ContinueButtonText="string"
    ContinueButtonType="Button|Image|Link"
    ContinueDestinationPageUrl="uri"
    CreateUserIconUrl="uri"
    CreateUserText="string"
    CreateUserUrl="uri"
    CssClass="string"
    DisplayUserName="True|False"
    EditProfileIconUrl="uri"
    EditProfileText="string"
    EditProfileUrl="uri"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
                Large|X-Large|XX-Large"
        Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    HelpPageIconUrl="uri"
    HelpPageText="string"
    HelpPageUrl="uri"
    ID="string"
    InstructionText="string"
    MailDefinition-BodyFileName="uri"
    MailDefinition-CC="string"
    MailDefinition-From="string"
    MailDefinition-IsBodyHtml="True|False"
    MailDefinition-Priority="Normal|Low|High"
    MailDefinition-Subject="string"
    MembershipProvider="string"
    NewPasswordLabelText="string"
    NewPasswordRegularExpression="string"
    NewPasswordRegularExpressionErrorMessage="string"
    NewPasswordRequiredErrorMessage="string"
    OnCancelButtonClick="CancelButtonClick event handler"
    OnChangedPassword="ChangedPassword event handler"
    OnChangePasswordError="ChangePasswordError event handler"
    OnChangingPassword="ChangingPassword event handler"
    OnContinueButtonClick="ContinueButtonClick event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSendingMail="SendingMail event handler"
    OnSendMailError="SendMailError event handler"
    OnUnload="Unload event handler"
    PasswordHintText="string"
    PasswordLabelText="string"
    PasswordRecoveryIconUrl="uri"
    PasswordRecoveryText="string"
    PasswordRecoveryUrl="uri"
    PasswordRequiredErrorMessage="string"
    runat="server"
    SkinID="string"
    Style="string"
    SuccessPageUrl="uri"
    SuccessText="string"
    SuccessTitleText="string"
    TabIndex="integer"
    ToolTip="string"
    UserName="string"
    UserNameLabelText="string"
    UserNameRequiredErrorMessage="string"
    Visible="True|False"
    Width="size"
>
        <CancelButtonStyle/>
        <ChangePasswordButtonStyle/>
        <ChangePasswordTemplate>
            <!-- child controls -->
        </ChangePasswordTemplate>
        <ContinueButtonStyle/>
        <FailureTextStyle/>
        <HyperLinkStyle/>
        <InstructionTextStyle/>
        <LabelStyle/>
        <MailDefinition
            BodyFileName="uri"
            CC="string"
            From="string"
            IsBodyHtml="True|False"
            Priority="Normal|Low|High"
            Subject="string"
>
                <EmbeddedObjects>
                        <asp:EmbeddedMailObject
                            Name="string"
                            Path="uri"
                        />
                </EmbeddedObjects>
        </MailDefinition>
        <PasswordHintStyle/>
        <SuccessTemplate>
            <!-- child controls -->
        </SuccessTemplate>
        <SuccessTextStyle/>
        <TextBoxStyle/>
        <TitleTextStyle/>
        <ValidatorTextStyle/>
</asp:ChangePassword>

Hinweise

Mit dem ChangePassword-Steuerelement auf einer Seite können Sie Websitebenutzern das Ändern des Kennworts ermöglichen, mit dem sie sich an der Website anmelden.

Sicherheitshinweis:
Das Übertragen von Kennwörtern über HTTP stellt ein potenzielles Sicherheitsrisiko dar. HTTP-Übertragungen können von böswilligen Benutzern angezeigt oder beschädigt werden. Um die Sicherheit bei der Verwendung von Anmeldesteuerelementen zu erhöhen, sollte das HTTPS-Protokoll mit SSL-Verschlüsselung (Secure Sockets Layer) verwendet werden, um sicherzustellen, dass das Kennwort des Benutzers während des Postbacks nicht gelesen werden kann. Weitere Informationen finden Sie unter Sichern von Anmeldungssteuerelementen.

Das Übertragen von Kennwörtern über HTTP stellt ein potenzielles Sicherheitsrisiko dar. HTTP-Übertragungen können von böswilligen Benutzern angezeigt oder beschädigt werden. Um die Sicherheit bei der Verwendung von Anmeldesteuerelementen zu erhöhen, sollte das HTTPS-Protokoll mit SSL-Verschlüsselung (Secure Sockets Layer) verwendet werden, um sicherzustellen, dass das Kennwort des Benutzers während des Postbacks nicht gelesen werden kann. Weitere Informationen finden Sie unter Sichern von Anmeldungssteuerelementen.

Das ChangePassword-Steuerelement ändert mithilfe des in der MembershipProvider-Eigenschaft definierten Mitgliedschaftsanbieters das Kennwort, das im Datenspeicher des Mitgliedschaftsanbieters für die Website gespeichert ist. Wenn Sie keinen Mitgliedschaftsanbieter zuweisen, verwendet das ChangePassword-Steuerelement den Standardmitgliedschaftsanbieter, der im Abschnitt Mitgliedschaft der Datei Web.config definiert ist.

Weitere Informationen zum Verwenden des ChangePassword-Steuerelements und anderer ASP.NET-Anmeldesteuerelemente finden Sie unter Übersicht über ASP.NET-Anmeldungssteuerelemente.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die NewPasswordRegularExpression-Eigenschaft zum Definieren eines regulären Ausdrucks festgelegt wird, der Kennwörter überprüft und sicherstellt, dass sie die folgenden Kriterien erfüllen:

Weisen mehr als sechs Zeichen auf.
Enthalten mindestens eine Ziffer.
Enthalten mindestens ein Sonderzeichen (nicht-alphanumerisch).

Dem Benutzer werden die Kennwortanforderungen angezeigt, die in der PasswordHintText-Eigenschaft enthalten sind.

Wenn das vom Benutzer eingegebene Kennwort die Anforderungen der NewPasswordRegularExpression-Eigenschaft nicht erfüllt, wird dem Benutzer der Text in der NewPasswordRegularExpressionErrorMessage-Eigenschaft angezeigt. Wenn kein neues Kennwort eingegeben wird, wird dem Benutzer der Text in der NewPasswordRequiredErrorMessage-Eigenschaft angezeigt.

Tipp

Das neue Kennwort muss die Mindestanforderungen erfüllen, die vom Mitgliedschaftsanbieter in den Eigenschaften MinRequiredPasswordLength, MinRequiredNonAlphanumericCharacters und PasswordStrengthRegularExpression festgelegt sind. Wenn das Kennwort diese Anforderungen nicht erfüllt, wird das ChangePasswordError-Ereignis ausgelöst.

<%@ page language="VB"%>

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

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>Change Password with Validation</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>
  <asp:changepassword id="ChangePassword1" runat="server"
  PasswordHintText = "Please enter a password at least 7 characters long, containing a number and one special character."
  NewPasswordRegularExpression = '@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})' 
  NewPasswordRegularExpressionErrorMessage = "Your password must be at least 7 characters long, and contain at least one number and one special character.">
  </asp:changepassword>
  </div>
  </form>
</body>
</html>

<%@ page language="C#"%>

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

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>Change Password with Validation</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>
  <asp:changepassword id="ChangePassword1" runat="server"
  PasswordHintText = 
    "Please enter a password at least 7 characters long, 
    containing a number and one special character."
  NewPasswordRegularExpression =
    '@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})' 
  NewPasswordRegularExpressionErrorMessage =
    "Error: Your password must be at least 7 characters long, 
    and contain at least one number and one special character." >
  </asp:changepassword>
  </div>
  </form>
</body>
</html>

Siehe auch

Referenz

ChangePassword

Weitere Ressourcen

Toolbox-Anmeldesteuerelemente

Last updated on 2008-09-03

Freigeben über