Exporter (0) Imprimer
Développer tout

PasswordRecovery, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Fournit des éléments d'interface utilisateur qui permettent à un utilisateur de récupérer ou de réinitialiser un mot de passe perdu et de le recevoir par courrier électronique.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

[BindableAttribute(false)] 
public class PasswordRecovery : CompositeControl
/** @attribute BindableAttribute(false) */ 
public class PasswordRecovery extends CompositeControl
BindableAttribute(false) 
public class PasswordRecovery extends CompositeControl

Le contrôle PasswordRecovery aide les utilisateurs qui ont oublié leurs mots de passe. Il permet à un utilisateur de demander un message électronique contenant un nouveau mot de passe ou le mot de passe déjà associé à son nom d'utilisateur.

RemarqueRemarque

Le contrôle Web PasswordRecovery utilise les services de messagerie Internet pour envoyer les mots de passe récupérés ou les nouveaux mots de passe aux utilisateurs. Il existe des problèmes de sécurité inhérents à l'envoi de mots de passe par courrier électronique. Vous devez déterminer si ces problèmes de sécurité sont admis par votre site.

Les utilisateurs peuvent récupérer des mots de passe uniquement lorsque le fournisseur d'appartenances a défini dans la propriété MembershipProvider prend en charge les mots de passe en texte clair ou chiffrés. Étant donné que les mots de passe hachés ne peuvent pas être récupérés, les utilisateurs des sites qui utilisent des mots de passe hachés peuvent uniquement réinitialiser leur mot de passe.

Remarque de sécuritéRemarque de sécurité

Accepter des entrées d'utilisateur constitue une menace potentielle pour la sécurité. Les utilisateurs mal intentionnés peuvent envoyer des données afin de détecter des lacunes ou d'exécuter des programmes qui essaient des mots de passe générés. Pour renforcer la sécurité lorsque vous travaillez avec une entrée d'utilisateur, vous devez utiliser les fonctionnalités de validation de votre contrôle et sécuriser tout fournisseur de données configuré pour votre contrôle. Pour plus d'informations, consultez Sécurisation des contrôles de connexion, Méthodes de sécurité de base pour les applications Web et Sécurisation de l'appartenance (membership).

RemarqueRemarque

Le contrôle PasswordRecovery peut être utilisé lorsqu'un utilisateur d'appartenance n'a pas été approuvé (MembershipUser.IsApproved a la valeur false), mais il ne peut pas être utilisé lorsqu'un utilisateur d'appartenance a été verrouillé (MembershipUser.IsLockedOut a la valeur true).

Le courrier électronique est envoyé à l'aide de la classe MailDefinition. Pour être capable d'envoyer un message électronique aux utilisateurs, vous devez configurer un serveur de messagerie dans le fichier Web.config de votre application. Vous pouvez modifier le contenu du message électronique envoyé aux utilisateurs en définissant un message personnalisé dans la propriété MailDefinition.

Vues

Le contrôle PasswordRecovery a trois états ou vues :

  • Vue du nom d'utilisateur : demande son nom d'utilisateur inscrit à l'utilisateur.

  • Vue de la question : requiert que l'utilisateur fournisse la réponse à une question stockée pour réinitialiser le mot de passe.

  • Vue de la réussite : indique à l'utilisateur si la récupération du mot de passe ou la réinitialisation est réussie.

Le contrôle PasswordRecovery affiche la vue de la question uniquement lorsque le fournisseur d'appartenances défini dans la propriété MembershipProvider prend en charge une question et une réponse à la question de mot de passe.

Le tableau suivant répertorie chaque propriété de style du contrôle PasswordRecovery et indique quelle vue elle affecte.

Propriété

Vue du nom d'utilisateur

Vue de la question

Vue Opération réussie

SubmitButtonStyle

Oui

Oui

Oui

FailureTextStyle

Oui

Oui

Non

HyperLinkStyle

Oui

Oui

Non

InstructionTextStyle

Oui

Oui

Non

LabelStyle

Oui

Oui

Non

SuccessTextStyle

Non

Non

Oui

TextBoxStyle

Oui

Oui

Non

TitleTextStyle

Oui

Oui

Oui

Styles et modèles

Vous pouvez utiliser un ensemble complet de propriétés de style pour personnaliser l'apparence du contrôle PasswordRecovery. Vous pouvez également appliquer des modèles personnalisés aux trois vues si vous devez contrôler entièrement l'apparence du contrôle. Vous pouvez utiliser les propriétés QuestionTemplate, SuccessTemplate et UserNameTemplate pour créer des modèles pour ces vues. Si vous définissez un modèle pour une vue, les propriétés de style de PasswordRecovery n'ont aucun effet.

Le tableau suivant répertorie les propriétés de style du contrôle PasswordRecovery et décrit l'élément d'interface que chacune des propriétés de style affecte. Pour obtenir la liste des propriétés auxquelles chaque style s'applique, consultez la documentation des propriétés de style.

Propriété du style

Élément de l'interface utilisateur affecté

SubmitButtonStyle

Envoyez des boutons sur toutes les vues.

FailureTextStyle

Texte d'erreur affiché à l'attention de l'utilisateur.

HyperLinkStyle

Liens vers d'autres pages.

InstructionTextStyle

Texte d'instruction sur la page qui décrit comment utiliser le contrôle.

LabelStyle

Étiquettes correspondant à tous les champs d'entrée, tels que les zones de texte.

TextBoxStyle

Champs d'entrée pour la saisie de texte.

TitleTextStyle

Texte de titre pour chaque vue.

SuccessTextStyle

Texte qui s'affiche à l'attention de l'utilisateur lorsque la récupération du mot de passe ou la tentative de réinitialisation est réussie.

Le tableau suivant répertorie quelles propriétés de modèle s'appliquent à chaque vue dans le contrôle PasswordRecovery. Pour obtenir la liste des contrôles que vous devez définir dans chaque modèle, consultez la documentation se rapportant aux propriétés de modèle.

Vue

Propriété de modèle

NomUtilisateur

UserNameTemplate

Question

QuestionTemplate

Succès

SuccessTemplate

Lorsque le contrôle PasswordRecovery n'est pas personnalisé avec les modèles, la propriété AccessKey du contrôle PasswordRecovery s'applique à la première zone de texte dans le contrôle et à la propriété TabIndex, qui s'applique à toutes les zones de texte du contrôle. Si le contrôle PasswordRecovery est personnalisé avec les modèles, la propriété AccessKey et la propriété TabIndex sont ignorées. Dans ce cas, définissez directement la propriété AccessKey et la propriété TabIndex de chaque contrôle enfant de modèle.

Les propriétés du contrôle PasswordRecovery représentées par des zones de texte, telles que Answer et Question, sont accessibles pendant toutes les phases du cycle de vie de la page. Le contrôle reprendra toutes modifications apportées par l'utilisateur final au moyen de l'événement TextChanged déclenché par les zones de texte.

Regroupements de validation

Le contrôle PasswordRecovery crée un groupe de validation pour tous les validateurs de champ requis dans le contrôle afin que d'autres contrôles d'entrée sur la page ne soient pas affectés par la validation du contrôle PasswordRecovery. Par défaut, la propriété ID du contrôle PasswordRecovery est utilisée comme nom du groupe de validation. Par exemple, un contrôle PasswordRecovery avec l'ID "PasswordRecovery1" utilisera le nom de groupe de validation "PasswordRecovery1". Si vous souhaitez que le contrôle PasswordRecovery participe à un autre groupe de validation, vous devez créer un modèle à partir du contrôle.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

L'exemple de code suivant illustre l'utilisation du contrôle PasswordRecovery.

<%@ 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">
    
    // Set the field label background color if the user name is not found.
    void PasswordRecovery1_UserLookupError(object sender, System.EventArgs e)
    {
        PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Red;
    }
    
    // Reset the field label background color.
    void PasswordRecovery1_Load(object sender, System.EventArgs e)
    {
        PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Black;
    }
</SCRIPT>

<HTML>
    <BODY>
        <FORM runat="server">
            <asp:PasswordRecovery id="PasswordRecovery1" runat="server" BorderStyle="Solid" BorderWidth="1px" BackColor="#F7F7DE"
                Font-Size="10pt" Font-Names="Verdana" BorderColor="#CCCC99" HelpPageText="Need help?" HelpPageUrl=recoveryHelp.aspx onuserlookuperror="PasswordRecovery1_UserLookupError" onload="PasswordRecovery1_Load" >
                <successtemplate>
                    <table border="0" style="font-size:10pt;">
                        <tr>
                            <td>Your password has been sent to you.</td>
                        </tr>
                    </table>
                </successtemplate>
                <titletextstyle font-bold="True" forecolor="White" backcolor="#6B696B">
                </titletextstyle>
            </asp:PasswordRecovery>

        </FORM>
    </BODY>
</HTML>

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.CompositeControl
        System.Web.UI.WebControls.PasswordRecovery

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft