Cette documentation est archivée et n’est pas conservée.

LoginView, classe

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

Affiche le modèle de contenu approprié pour un utilisateur donné, en fonction de l'état d'authentification et de l'appartenance à un rôle de l'utilisateur.

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

[BindableAttribute(false)] 
[ThemeableAttribute(true)] 
public class LoginView : Control, INamingContainer
/** @attribute BindableAttribute(false) */ 
/** @attribute ThemeableAttribute(true) */ 
public class LoginView extends Control implements INamingContainer
BindableAttribute(false) 
ThemeableAttribute(true) 
public class LoginView extends Control implements INamingContainer

Le contrôle LoginView affiche les différents modèles de contenu de site Web (ou « affichages ») pour les différents utilisateurs, selon que l'utilisateur est authentifié ou non et, le cas échéant, les rôles de site Web auxquels il (elle) appartient.

Le modèle stocké dans la propriété AnonymousTemplate s'affiche pour tout visiteur du site Web qui ne s'est pas connecté. Une fois qu'un utilisateur se connecte, le site affiche un modèle associé à l'un des rôles de l'utilisateur dans la propriété RoleGroups ou le modèle par défaut spécifié dans la propriété LoggedInTemplate.

Le contrôle LoginView gère la permutation entre les différents modèles une fois que vous assignez ces derniers à l'une des trois propriétés de modèle de la classe LoginView :

  • AnonymousTemplate Spécifie le modèle à afficher pour les utilisateurs qui ne sont pas connectés au site Web. Les utilisateurs connectés ne verront jamais ce modèle.

  • LoggedInTemplate Spécifie le modèle par défaut à afficher pour les utilisateurs connectés au site Web, mais qui n'appartiennent à aucun groupe de rôles avec des modèles définis.

  • RoleGroups Spécifie le modèle à afficher pour les utilisateurs connectés qui sont membres de rôles avec des modèles de groupe de rôles définis. Les modèles de contenu sont associés à des ensembles de rôles particuliers dans les instances de RoleGroup.

Les modèles de groupe de rôles sont recherchés suivant l'ordre dans lequel ils sont définis dans la source. Le premier modèle de groupe de rôles de correspondance s'affiche à l'intention de l'utilisateur. Si l'utilisateur est membre de plusieurs rôles, le premier modèle de groupe de rôles qui correspond à un des rôles de l'utilisateur est utilisé. Si plusieurs modèles sont associés à un rôle unique, seul le premier modèle défini est utilisé.

Le tableau suivant décrit le comportement du contrôle LoginView lorsque plusieurs combinaisons de modèles sont utilisées.

Propriété de modèle LoggedIn

Propriété de modèle anonyme

Propriété RoleGroups

Comportement LoginView

Non définie

Non définie

Non définie

N'affiche aucun contenu.

Définie

Non définie

Non définie

Affiche le contenu uniquement lorsque l'utilisateur est connecté.

Non définie

Définie

Non définie

Affiche le contenu uniquement lorsque l'utilisateur n'est pas connecté.

Non définie

Non définie

Définie

Affiche le premier modèle de la collection RoleGroups qui correspond à l'un des rôles de l'utilisateur. Si aucune correspondance n'est trouvée, n'affiche aucun contenu.

Définie

Définie

Non définie

Si l'utilisateur est connecté, affiche le modèle spécifié dans la propriété LoggedInTemplate. Si l'utilisateur n'est pas connecté, affiche le modèle spécifié dans la propriété AnonymousTemplate.

Définie

Définie

Définie

Si l'utilisateur est connecté, affiche le premier modèle de la collection RoleGroups qui correspond à l'un des rôles de l'utilisateur. Si aucune correspondance n'est trouvée, affiche le modèle spécifié dans la propriété LoggedInTemplate. Si l'utilisateur n'est pas connecté, affiche le modèle spécifié dans la propriété AnonymousTemplate.

Définie

Non définie

Définie

Si l'utilisateur est connecté, affiche le premier modèle de la collection RoleGroups qui correspond à l'un des rôles de l'utilisateur. Si aucune correspondance n'est trouvée, affiche le modèle spécifié dans la propriété LoggedInTemplate. Si l'utilisateur n'est pas connecté, rien ne s'affiche.

Non définie

Définie

Définie

Si l'utilisateur est connecté, affiche le premier modèle de la collection RoleGroups qui correspond à l'un des rôles de l'utilisateur. Si aucune correspondance n'est trouvée, rien ne s'affiche. Si l'utilisateur n'est pas connecté, affiche le modèle spécifié dans la propriété AnonymousTemplate.

Les AnonymousTemplate et LoggedInTemplate peuvent être utilisés avec n'importe quel schéma d'authentification qui définit la propriété Name de la propriété User de l'objet Page. Vous devez configurer la gestion des rôles pour utiliser la propriété RoleGroups afin de définir les modèles en fonction du rôle de l'utilisateur sur le site Web. Pour plus d'informations, consultez Présentation de la gestion des rôles.

La méthode Focus n'affecte pas le contrôle LoginView, ou un de ses contrôles enfants, au focus initial de la page Web. Les contrôles contenus dans le contrôle LoginView sont créés après l'événement PreRender. Pour affecter le focus à un contrôle enfant que contient le LoginView, gérez le On_PreRender et appelez sa méthode Focus. Vous pouvez également utiliser les événements ViewChanging et ViewChanged pour accéder par programme aux contrôles des modèles de contrôle LoginView.

L'exemple de code suivant montre comment définir des modèles pour chacun des trois types de modèle pris en charge par le contrôle LoginView.

<%@ 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>
    <BODY>
        <FORM runat="server">
            <P>
                <asp:LoginStatus id="LoginStatus1" runat="server"></asp:LoginStatus></P>
            <P>
                <asp:LoginView id="LoginView1" runat="server">
                    <AnonymousTemplate>
                        Please log in for personalized information.
                    </AnonymousTemplate>
                    <LoggedInTemplate>
                        Thanks for logging in 
                        <asp:LoginName id="LoginName1" runat="Server"></asp:LoginName>.
                    </LoggedInTemplate>
                    <RoleGroups>
                        <asp:RoleGroup Roles="Admin">
                            <ContentTemplate>
                                <asp:LoginName id="LoginName2" runat="Server"></asp:LoginName>, you
                                are logged in as an administrator.
                            </ContentTemplate>
                        </asp:RoleGroup>
                    </RoleGroups>
                </asp:LoginView></P>
        </FORM>
    </BODY>
</HTML>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.Web.UI.Control
    System.Web.UI.WebControls.LoginView

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