Cenni preliminari sul controllo server Web BulletedList

Aggiornamento: novembre 2007

Il controllo BulletedList crea un elenco di elementi non ordinato o ordinato (numerato), rappresentati rispettivamente come elementi HTML ul oppure ol.

Vengono illustrati i seguenti argomenti:

• Scenari

• Funzionalità

• Background

• Procedure e procedure dettagliate

• Riferimento alle classi

Scenari

Utilizzare il controllo BulletedList per effettuare le seguenti operazioni:

• Specificare l'aspetto degli elementi e degli elenchi puntati o numerati.

• Definire gli elementi dell'elenco staticamente o associando il controllo ai dati.

• Rispondere ai clic dell'utente sugli elementi.

Torna all'inizio

Funzionalità

Quando si utilizza il controllo BulletedList, è possibile effettuare le seguenti operazioni:

• Personalizzare l'aspetto degli elenchi puntati e numerati.

• Specificare come viene rappresentato ogni elemento dell'elenco, ad esempio collegamento ipertestuale, testo statico o pulsante di collegamento.

• Fornire la logica per eseguire le attività specifiche dell'applicazione quando un utente fa clic su un elemento.

Torna all'inizio

Background

Il controllo BulletedList deriva dalla stessa classe ListControl dei controlli ListBox, DropDownList e di altri controlli elenco ASP.NET. Pertanto, il controllo BulletedList funziona in modo analogo a tali controlli. Per definire elementi di elenco per il controllo BulletedList, è possibile creare elementi statici oppure associare il controllo a un'origine dati. Se in fase di progettazione sono stati individuati gli elementi da visualizzare, è possibile impostare l'insieme Items del controllo su un insieme di singoli elementi nel markup. Se gli elementi da visualizzare sono dinamici, è possibile creare l'insieme di elementi in codice in fase di esecuzione. Per informazioni dettagliate, vedere Procedura: aggiungere elementi nei controlli server Web elenco (Visual Studio).

In alternativa, è possibile associare il controllo a un'origine dati che contiene le informazioni da visualizzare. Per informazioni dettagliate, vedere Procedura: inserire nei controlli server Web elenco i dati ottenuti da un'origine dati (Visual Studio).

È possibile combinare elementi statici con elementi derivanti dall'associazione dati impostando la proprietà AppendDataBoundItems del controllo su true.

Quando si definiscono degli elementi per il controllo BulletedList, vengono definite due proprietà: la proprietà Text e la proprietà Value. La proprietà Text definisce il controllo da visualizzare sulla pagina. La proprietà Value definisce un secondo valore che non viene visualizzato, ma che può essere restituito quando un utente seleziona un elemento. È possibile, ad esempio, visualizzare il nome di un impiegato come testo di un elemento, ma utilizzare l'ID dell'impiegato come valore. In questo modo quando l'utente fa clic sull'elemento, sarà possibile leggere direttamente il valore.

Nota sulla sicurezza:
Non utilizzare dati riservati, quali i numeri dei clienti, come valore di una proprietà del controllo BulletedList. Sebbene non siano visibili, le impostazioni della proprietà Value di singoli elementi vengono rappresentate nella pagina, dove gli utenti possono leggerle facilmente nell'origine della pagina.

Personalizzazione dell'aspetto degli elementi di un elenco

Il controllo BulletedList può rappresentare sia punti che numeri, a seconda dell'impostazione della proprietà BulletStyle. Se il controllo è impostato per rappresentare dei punti elenco, è possibile selezionare i campi predefiniti relativi allo stile dei punti elenco che corrispondono agli stili dei punti elenco HTML standard, come quelli rappresentati dai campi Disc, Circle e Square.

Nota:
Il rendering dei punti varia da browser a browser e alcuni browser non supportano determinati stili di punti elenco, ad esempio il campo Disc.

Al posto del punto è possibile specificare la visualizzazione di un'immagine personalizzata.

Se il controllo è impostato per rappresentare numeri, è possibile selezionare un'opzione di numerazione standard HTML, ad esempio i campi LowerAlpha, UpperAlpha, LowerRoman e UpperAlpha. Impostando la proprietà FirstBulletNumber è possibile anche specificare un numero di inizio per la sequenza.

Specifica della modalità di visualizzazione degli elementi

Il controllo BulletedList può visualizzare uno dei seguenti elementi dell'elenco:

• Testo statico   Il testo visualizzato dal controllo non è interattivo.

• Controlli T:System.Web.UI.WebControls.HyperLink   Gli utenti possono fare clic sui collegamenti per passare a un'altra pagina. È necessario fornire un URL di destinazione come proprietà Value di singoli elementi.

• LinkButton Controlli    Gli utenti possono fare clic su singoli elementi e il controllo esegue un postback.

Risposta alla selezione utente

Se il controllo BulletedList è configurato per la visualizzazione di singoli elementi come controlli LinkButton, quando un utente fa clic su un elemento il controllo esegue un postback. Il postback genera l'evento Click del controllo BulletedList, nel quale è possibile fornire la logica per l'esecuzione di attività specifiche dell'applicazione. L'evento passa il numero di indice dell'elemento sul quale è stato fatto clic. Per informazioni dettagliate, vedere Procedura: rispondere ai clic dell'utente nei controlli server Web BulletedList (Visual Studio).

Procedure e procedure dettagliate

• Procedura: aggiungere controlli server Web BulletedList a una pagina Web Form (Visual Studio)

• Procedura: rispondere ai clic dell'utente nei controlli server Web BulletedList (Visual Studio)

Riferimento alle classi

Nella tabella riportata di seguito sono elencate le classi correlate al controllo BulletedList.

Membro	Descrizione
BulletedList	La classe principale per il controllo.
BulletedListDisplayMode	Un'enumerazione che specifica il comportamento di visualizzazione di ogni elemento.
BulletedListEventArgs	I dati degli eventi che indicano l'indice dell'elemento selezionato.
BulletedListEventHandler	Il metodo che gestisce l'evento Click di un controllo BulletedList.
BulletStyle	Un'enumerazione che specifica i tipi di elenchi puntati, numerati o contrassegnati da lettere che è possibile visualizzare.

Torna all'inizio

Vedere anche

Attività

Procedura: aggiungere elementi nei controlli server Web elenco (Visual Studio)

Procedura: inserire nei controlli server Web elenco i dati ottenuti da un'origine dati (Visual Studio)

Procedura: impostare la selezione nei controlli server Web elenco (Visual Studio)