Partager via


Syntaxe déclarative des contrôles serveur Web ChangePassword

Mise à jour : novembre 2007

Crée une interface utilisateur qui permet aux utilisateurs de modifier le mot de passe qu'ils utilisent pour se connecter au site Web.

<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>

Notes

Utilisez le contrôle ChangePassword sur une page pour permettre aux utilisateurs de votre site Web de modifier le mot de passe qu'ils utilisent pour se connecter à votre site Web.

Note de sécurité :

La transmission de mots de passe sur le protocole HTTP constitue une vulnérabilité potentielle pour la sécurité. Les transmissions HTTP peuvent être affichées ou mises en danger par des utilisateurs malveillants. Pour améliorer la sécurité lors de l'utilisation de contrôles d'ouverture de session, vous devez utiliser le protocole HTTPS avec le chiffrement SSL (Secure Sockets Layer) pour garantir que le mot de passe de l'utilisateur ne puisse pas être lu pendant la publication. Pour plus d'informations, consultez Sécurisation des contrôles de connexion.

Le contrôle ChangePassword utilise le fournisseur d'appartenances défini dans la propriété MembershipProvider pour modifier le mot de passe stocké dans le magasin de données du fournisseur d'appartenances du site Web. Si vous n'assignez pas de fournisseur d'appartenances, le contrôle ChangePassword utilise le fournisseur d'appartenances par défaut défini dans la section Membership du fichier Web.config.

Pour plus d'informations sur l'utilisation du contrôle ChangePassword et d'autres contrôles de connexion ASP.NET, consultez Vue d'ensemble des contrôles de connexion ASP.NET.

Exemple

L'exemple de code suivant montre comment définir la propriété NewPasswordRegularExpression de façon à créer une expression régulière qui vérifie les mots de passe et garantit qu'ils répondent aux critères suivants :

  • Comportent plus de six caractères.

  • Comportent au moins un chiffre.

  • Comportent au moins un caractère spécial (non alphanumérique).

Les conditions de mot de passe requises contenues dans la propriété PasswordHintText s'affichent à l'attention de l'utilisateur.

Si le mot de passe entré par l'utilisateur ne répond pas aux conditions requises de la propriété NewPasswordRegularExpression, le texte contenu dans la propriété NewPasswordRegularExpressionErrorMessage est affiché à l'attention de l'utilisateur. Si aucun nouveau mot de passe n'est entré, le texte contenu dans la propriété NewPasswordRequiredErrorMessage est affiché à l'attention de l'utilisateur.

Remarque :

Le nouveau mot de passe doit satisfaire les conditions minimales requises définies par le fournisseur d'appartenances dans les propriétés MinRequiredPasswordLength, MinRequiredNonAlphanumericCharacters et PasswordStrengthRegularExpression. Si le mot de passe ne satisfait pas les conditions requises, l'événement ChangePasswordError est déclenché.

<%@ 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>

Voir aussi

Référence

ChangePassword

Autres ressources

Contrôles de boîte à outils de connexion