Exporter (0) Imprimer
Développer tout

BulletedList.DisplayMode, propriété

Mise à jour : novembre 2007

Obtient ou définit le mode d'affichage du contenu de la liste dans un contrôle BulletedList.

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

public virtual BulletedListDisplayMode DisplayMode { get; set; }
/** @property */
public BulletedListDisplayMode get_DisplayMode()
/** @property */
public  void set_DisplayMode(BulletedListDisplayMode value)

public function get DisplayMode () : BulletedListDisplayMode
public function set DisplayMode (value : BulletedListDisplayMode)
<asp:BulletedList DisplayMode="BulletedListDisplayMode" />

Valeur de propriété

Type : System.Web.UI.WebControls.BulletedListDisplayMode

Une des valeurs de BulletedListDisplayMode. La valeur par défaut est Text.

ExceptionCondition
ArgumentOutOfRangeException

Le type spécifié n'est pas l'une des valeurs BulletedListDisplayMode.

Utilisez la propriété DisplayMode pour spécifier le comportement d'affichage à appliquer au contenu d'éléments de liste dans un contrôle BulletedList. La propriété DisplayMode peut recevoir l'une des valeurs d'énumération BulletedListDisplayMode. Le tableau suivant énumère les valeurs possibles.

Valeur

Affiché comme

Text

Texte.

HyperLink

Liens hypertexte.

LinkButton

Boutons de lien.

La valeur HyperLink vous permet d'afficher le contenu de la liste sous la forme de liens hypertexte. Si vous cliquez dessus, un lien hypertexte vous fera naviguer vers une URL. Utilisez la propriété Value pour spécifier l'URL à atteindre.

Le champ LinkButton vous permet d'afficher le contenu de la liste sous forme de lien. Utilisez l'événement BulletedList.Click pour publier sur le serveur lorsqu'un clic est effectué sur un bouton de lien.

La valeur de cette propriété est stockée dans l'état d'affichage.

L'exemple de code suivant illustre la création d'un contrôle BulletedList et la définition de la propriété DisplayMode. Un contrôle ListBox est rempli avec les valeurs d'énumération BulletedListDisplayMode. Le format du contenu d'élément de liste change selon le mode d'affichage que l'utilisateur sélectionne dans la zone de liste.

<%@ Page Language="VB" %>

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

        Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)

            ' Change the message displayed, based on 
            ' the display mode selected from the list box.
            If DisplayModeListBox.SelectedIndex > -1 Then
                Message1.Text = "You chose: " & DisplayModeListBox.SelectedItem.Text
            End If

            ' Change the display mode, based on 
            ' the mode selected from the list box.
            Select Case (DisplayModeListBox.SelectedIndex)
                Case 0
                    ItemsBulletedList.DisplayMode = BulletedListDisplayMode.Text
                    Message2.Text = ""
                Case 1
                    ItemsBulletedList.DisplayMode = BulletedListDisplayMode.HyperLink
                    ' Opens a new browser window to display the page linked to.
                    ItemsBulletedList.Target = "_blank"
                    Message2.Text = ""
                Case 2
                    ItemsBulletedList.DisplayMode = BulletedListDisplayMode.LinkButton
                Case Else
                    Throw New Exception("You did not select a valid display mode.")
            End Select

        End Sub

        Sub ItemsBulletedList_Click(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)

            ' Change the message displayed, based on the index
            ' of the bulletedlist list item that was clicked.
            Select Case (e.Index)
                Case 0
                    Message2.Text = "You  clicked list item 1."
                Case 1
                    Message2.Text = "You  clicked list item 2."
                Case 2
                    Message2.Text = "You  clicked list item 3."
                Case Else
                    Throw New Exception("You did not click a valid list item.")
            End Select

        End Sub

</script>

</head>
<body>

    <h3>DisplayMode Example</h3>

    <form id="form1" runat="server">  
    <h3>BulletedListDisplayMode Example</h3>
    <p>
    <asp:BulletedList id="ItemsBulletedList" 
        BulletStyle="Disc"
        DisplayMode="Text" 
        OnClick="ItemsBulletedList_Click"
        runat="server">    
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList></p>    

        <hr />      

        <h4>Select from the list to change the display mode:</h4>            
    <asp:ListBox id="DisplayModeListBox" 
        Rows="1"
            SelectionMode="Single"
            AutoPostBack="True"
            OnSelectedIndexChanged="Index_Changed"
        runat="server">             
            <asp:ListItem>Text</asp:ListItem>
            <asp:ListItem>Hyperlink</asp:ListItem>
            <asp:ListItem>LinkButton</asp:ListItem>
    </asp:ListBox>    

    <asp:Label id="Message1" 
        runat="server"
        AssociatedControlID="DisplayModeListBox"/><br /><br />

        <asp:Label id="Message2"
            runat="server"
            AssociatedControlID="DisplayModeListBox"/>         

   </form>

</body>
</html>


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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft