Comment : utiliser les fonctionnalités avancées du contrôle de connexion ASP.NET

Mise à jour : novembre 2007

Le contrôle Login est un contrôle composite qui fournit tous les éléments d'interface utilisateur courants d'un formulaire de connexion. Le contrôle est modulaire et chaque partie peut être personnalisée individuellement. Ces parties incluent les zones de texte Nom d'utilisateur et Mot de passe, le bouton Envoyer, le bouton pour créer un utilisateur, la case à cocher Mémoriser mes informations et des informations d'aide pour l'utilisateur. Vous pouvez définir votre propre interface utilisateur pour le contrôle de connexion en définissant de nouveaux éléments et en réutilisant des composants par défaut. Vous pouvez également personnaliser le texte de l'interface utilisateur et l'apparence (polices et couleurs) du contrôle Login. Vous pouvez également modifier l'apparence générale du contrôle Login en appliquant un thème ou une apparence ASP.NET.

De plus, vous pouvez utiliser des fonctions plus avancées du contrôle Login, telles que la fonction permettant de déterminer si les informations de connexion sont stockées dans un cookie persistant du navigateur ou si le contrôle de connexion est visible (sur des pages différentes de la page de connexion par défaut) lorsqu'un utilisateur est connecté. Enfin, vous pouvez convertir le contrôle de connexion en un modèle pour contrôler totalement l'apparence du contrôle.

Pour contrôler si le contrôle de connexion est visible lorsqu'un utilisateur est connecté

  1. Ajoutez un Login sur une page.

    Remarque :

    Par défaut, le contrôle est configuré pour utiliser une page de connexion nommée Login.aspx. Vous pouvez modifier le nom de la page de connexion dans le fichier Web.config en définissant la propriété LoginUrl de la classe FormsAuthentication.

  2. Si vous souhaitez que le contrôle Login apparaisse uniquement lorsqu'un utilisateur n'est pas connecté, (le contrôle sera toujours affiché sur la page de connexion identifiée par la propriété LoginUrl), affectez la valeur false à la propriété VisibleWhenLoggedIn.

  1. Si vous souhaitez que le contrôle affiche une case à cocher Mémoriser le mot de passe, affectez la valeur true à la propriété DisplayRememberMe. Si un utilisateur active la case à cocher Mémoriser le mot de passe lorsqu'il ou elle se connecte, le jeton d'authentification sera stocké dans un cookie persistant du navigateur.

  2. Si vous souhaitez que la case à cocher Mémoriser le mot de passe soit activée par défaut, affectez la valeur true à la propriété RememberMeSet.

  3. Si vous souhaitez que le jeton d'authentification soit stocké dans un cookie persistant sans permettre à l'utilisateur de désactiver la case à cocher Mémoriser le mot de passe, affectez la valeur true à la propriété RememberMeSet et la valeur false à la propriété DisplayRememberMe. Cela n'est pas recommandé pour les sites auxquels il est possible d'accéder depuis des ordinateurs publics qui servent à plusieurs utilisateurs, étant donné que le jeton d'authentification persistant d'un utilisateur pourrait être utilisé par un utilisateur non souhaité.

Pour ajouter des liens d'aide au contrôle Login

  1. Pour ajouter un lien au contrôle Login qui dirige l'utilisateur vers une URL où il ou elle peut créer un nouveau compte utilisateur, affectez du texte, tel que Cliquez ici pour s'enregistrer, à la propriété CreateUserText et l'URL de la page d'aide, telle que ~/register.aspx, à la propriété CreateUserUrl.

    Remarque :

    Pour cette étape et les étapes suivantes, les URL de destination doivent figurer à un emplacement qui ne requiert pas d'authentification.

  2. Pour ajouter un lien au contrôle Login qui dirige l'utilisateur vers une URL permettant aux utilisateurs de récupérer leur mot de passe, affectez du texte, tel que Vous avez oublié votre mot de passe ?, à la propriété PasswordRecoveryText et l'URL de la page d'aide, telle que ~/recoverpassword.aspx, à la propriété PasswordRecoveryUrl.

  3. Pour ajouter un lien au contrôle Login qui dirige l'utilisateur vers une URL d'aide, affectez du texte, tel que Besoin d'aide? à la propriété HelpPageText et l'URL de la page d'aide, telle que ~/userhelp.aspx, à la propriété HelpPageUrl.

Pour ajouter des images au contrôle Login

  • Pour utiliser une image à la place d'un bouton Se connecter, affectez l'URL de votre fichier image de connexion, telle que ~/images/login.gif, à la propriété LoginButtonImageUrl.

    Vous pouvez également inclure des images avec les liens vers l'URL de création d'utilisateur, l'URL de récupération de mot de passe et l'URL d'aide à l'aide des propriétés PasswordRecoveryIconUrl, CreateUserIconUrl et HelpPageIconUrl, respectivement.

Conversion du contrôle de connexion en un modèle

Vous pouvez convertir le contrôle Login en un modèle qui est défini dans le balisage comme une table qui contient des contrôles ASP.NET, tels que Label et TextBox. Vous pouvez utiliser ensuite ces éléments ou ajouter vos propres éléments pour créer un modèle personnalisé pour votre contrôle Login. Notez que les mêmes ID de contrôle sont utilisés pour les contrôles qui composent le modèle de connexion comme dans le modèle par défaut.

Pour utiliser un modèle avec le contrôle de connexion

  1. Placez un contrôle Login sur une page en mode Design.

  2. Cliquez avec le bouton droit sur le contrôle et sélectionnez Convertir en modèle dans le menu contextuel.

Le mode de conversion du contrôle Login dépend de la déclaration DOCTYPE. Si la déclaration DOCTYPE a pour valeur XHTML 1.0 Transitional (<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">), les styles sont appliqués à la table qui est créée lorsque le contrôle Login est converti en un modèle. Si la déclaration DOCTYPE n'a pas pour valeur XHTML 1.0 Transitional ou est absente, aucune information de style n'est enregistrée dans la table externe qui est générée.

Par exemple, si vous définissez la taille de police relative sur le contrôle Login, puis convertissez le contrôle en un modèle, la taille de police relative n'est pas enregistrée dans la table. L'exemple suivant illustre un contrôle Login dont la valeur de taille de police est X-Large.

<asp:login id="Login2"  font-size="X-Large" BackColor="#F7F6F3" BorderColor="#E6E2D8" BorderPadding="4" BorderStyle="Solid" BorderWidth="1px" Font-Names="Verdana" ForeColor="#333333">
    <TitleTextStyle BackColor="#5D7B9D" Font-Bold="True" Font-Size="0.9em" ForeColor="White" />
    <InstructionTextStyle Font-Italic="True" ForeColor="Black" />
   <TextBoxStyle Font-Size="0.8em" />
    <LoginButtonStyle BackColor="#FFFBFF" BorderColor="#CCCCCC" BorderStyle="Solid" BorderWidth="1px"
    Font-Names="Verdana" Font-Size="0.8em" ForeColor="#284775" />
</asp:login>

Lorsque le contrôle Login dans le code ci-dessus est converti en un modèle, aucun des styles n'est appliqué à la table créée. L'exemple suivant est un extrait du code généré à partir du contrôle ci-dessus lorsqu'il est converti en un modèle.

<asp:login id="Login2"  font-size="X-Large" BackColor="#F7F6F3" BorderColor="#E6E2D8" BorderPadding="4" BorderStyle="Solid" BorderWidth="1px" Font-Names="Verdana" ForeColor="#333333">
    <TitleTextStyle BackColor="#5D7B9D" Font-Bold="True" Font-Size="0.9em" ForeColor="White" />
    <InstructionTextStyle Font-Italic="True" ForeColor="Black" />
    <TextBoxStyle Font-Size="0.8em" />
    <LoginButtonStyle BackColor="#FFFBFF" BorderColor="#CCCCCC" BorderStyle="Solid" BorderWidth="1px"
    Font-Names="Verdana" Font-Size="0.8em" ForeColor="#284775" />
    <LayoutTemplate>
    <table border="0" cellpadding="4" cellspacing="0" style="border-collapse: collapse">
...

Si vous souhaitez que les attributs de style s'appliquent également à la table créée lorsque vous convertissez le contrôle Login en un modèle, assurez-vous que la déclaration DOCTYPE de la page a pour valeur XHTML 1.0 Transitional avant de sélectionner Convertir en modèle dans le menu de contrôle en mode Design.

Voir aussi

Concepts

Personnalisation de l'apparence des contrôles de connexion ASP.NET

Vue d'ensemble des thèmes et des apparences ASP.NET

Autres ressources

Contrôles de boîte à outils de connexion

  • Last updated on