Cenni preliminari sul controllo server Web ListBox

Articolo
10/22/2014

Aggiornamento: novembre 2007

Il controllo server Web ListBox consente all'utente di selezionare uno o più elementi da un elenco già definito.

Vengono illustrati i seguenti argomenti:

Scenari
Funzionalità
Background
Esempi di codice
Riferimento alle classi

Scenari

Utilizzare il controllo server Web ListBox quando si desidera visualizzare più elementi contemporaneamente e consentire agli utenti di selezionare uno o più elementi da un elenco predefinito. Il controllo ListBox differisce da un controllo DropDownList in quanto può visualizzare più elementi contemporaneamente e consente facoltativamente all'utente di selezionare più elementi.

Torna all'inizio

Funzionalità

È possibile utilizzare il controllo ListBox per:

Impostare il controllo per la visualizzazione di un numero specifico di elementi.
Impostare le dimensioni del controllo in pixel.
Utilizzare l'associazione dati per specificare l'elenco di elementi da visualizzare.
Determinare l'elemento o gli elementi selezionati.
Specificare a livello di codice l'elemento o gli elementi selezionati.

Torna all'inizio

Background

Il controllo ListBox in genere viene utilizzato per visualizzare più elementi contemporaneamente. È possibile controllare l'aspetto dell'elenco nei seguenti modi:

Numero di righe visualizzate. È possibile impostare il controllo per la visualizzazione di un numero specifico di elementi. Se il controllo contiene più elementi di quelli specificati, verrà visualizzata una barra di scorrimento verticale.
Altezza e larghezza. È possibile impostare le dimensioni del controllo mediante pixel. In tal caso, il controllo ignorerà il numero di righe impostato e visualizzerà il numero di righe consentito dall'altezza del controllo. Alcuni browser non supportano l'impostazione dell'altezza e della larghezza in pixel e utilizzano l'impostazione basata sul numero delle righe.

Come per altri controlli server Web, è possibile utilizzare oggetti di stile per personalizzare l'aspetto del controllo. Per informazioni, vedere Controlli server Web ASP.NET e stili CSS.

Elementi di un elenco

Il controllo ListBox è un contenitore per uno o più elementi di un elenco. Ogni elemento dell'elenco è un oggetto di tipo ListItem dotato di proprietà specifiche descritte nella tabella riportata di seguito.

Proprietà	Descrizione
Text	Specifica il testo visualizzato nell'elenco.
Value	Contiene il valore associato a un elemento. L'impostazione di questa proprietà consente di associare un valore a un elemento specifico senza visualizzarlo. È ad esempio possibile impostare la proprietà Text sul nome di un colore e la proprietà Value sulla relativa rappresentazione esadecimale.
Selected	Indica se l'elemento è attualmente selezionato.

Per gestire gli elementi a livello di codice è necessario utilizzare l'insieme Items del controllo ListBox. L'insieme Items è un insieme standard ed è quindi possibile cancellarlo, aggiungervi oggetti o eliminarli e così via.

L'elemento selezionato è disponibile nella proprietà SelectedItem del controllo ListBox. Se il controllo è impostato sulla modalità di selezione singola, la proprietà restituisce l'unico elemento selezionato. Se il controllo è impostato sulla modalità di selezione multipla, è possibile ottenere gli elementi selezionati scorrendo l'intero insieme Items ed esaminando la proprietà Selected di ciascun elemento.

Selezione singola e selezione multipla

L'utente in genere può selezionare un singolo elemento nell'elenco facendo clic su di esso. Se si imposta il controllo ListBox in modo da consentire la selezione multipla, l'utente potrà tenere premuto CTRL o MAIUSC mentre fa clic con il mouse per selezionare più elementi.

Associazione di dati al controllo

È possibile utilizzare un controllo server Web ListBox per visualizzare nella pagina un elenco di opzioni ricavate da un controllo origine dati. Ogni elemento del controllo ListBox corrisponde a un elemento dell'origine dati, generalmente un singolo record di dati.

Il controllo visualizza un campo dell'origine. Per impostare il valore di un elemento non visualizzato è anche possibile associare il controllo a un secondo campo.

Come per altri controlli server, è possibile associare a dati una qualsiasi proprietà del controllo, ad esempio il colore o le dimensioni. Per informazioni dettagliate, vedere Procedura: inserire nei controlli server Web elenco i dati ottenuti da un'origine dati (Visual Studio).

Eventi di ListBox

Quando un utente seleziona un elemento, il controllo ListBox genera l'evento SelectedIndexChanged. Per impostazione predefinita, questo evento non determina l'invio della pagina al server. Se tuttavia si desidera che il controllo forzi un postback immediato, impostare la proprietà AutoPostBack su true.

Nota:
La funzionalità di postback automatico richiede che il browser supporti ECMAScript (JScript o JavaScript) e che nel browser dell'utente sia attivato lo scripting.