Questa documentazione è stata archiviata e non viene gestita.

Proprietà BulletedList.DisplayMode

Aggiornamento: novembre 2007

Ottiene o imposta la modalità di visualizzazione del contenuto dell'elenco in un controllo BulletedList.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in 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" />

Valore proprietà

Tipo: System.Web.UI.WebControls.BulletedListDisplayMode

Uno dei valori di BulletedListDisplayMode. Il valore predefinito è Text.

EccezioneCondizione
ArgumentOutOfRangeException

Il tipo specificato non è uno dei valori di BulletedListDisplayMode.

Utilizzare la proprietà DisplayMode per specificare il comportamento di visualizzazione da applicare al contenuto degli elementi di elenco in un controllo BulletedList. La proprietà DisplayMode viene impostata utilizzando uno dei valori di enumerazione di BulletedListDisplayMode. Nella tabella che segue sono elencati i valori possibili.

Valore

Visualizzazione

Text

Testo.

HyperLink

Collegamenti ipertestuali.

LinkButton

Pulsanti di collegamento.

Il valore di HyperLink consente di visualizzare il contenuto dell'elenco come collegamenti ipertestuali. Quando si fa clic su un collegamento ipertestuale, questo si sposta su un URL. Utilizzare la proprietà Value per specificare l'URL di destinazione del collegamento ipertestuale.

Il campo LinkButton consente di visualizzare il contenuto dell'elenco come collegamenti. Utilizzare l'evento BulletedList.Click per eseguire il postback al server quando si fa clic su un pulsante di collegamento.

Il valore di questa proprietà è memorizzato in stato di visualizzazione.

Nell'esempio di codice riportato di seguito viene illustrato come creare un controllo BulletedList e impostare la proprietà DisplayMode. In un controllo ListBox vengono inseriti i valori di enumerazione di BulletedListDisplayMode. Il formato del contenuto dell'elemento di elenco si modifica in base alla modalità di visualizzazione selezionata dall'utente dalla casella di riepilogo.

<%@ 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 Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0
Mostra: