Introduzione al controllo DataRepeater (Visual Studio)

Articolo
06/10/2015

Il controllo DataRepeater di Visual Basic Power Pack 1.1 è un contenitore scorrevole di controlli per la visualizzazione di dati ripetuti quali, ad esempio, le righe di una tabella di database. Può essere utilizzato in alternativa al controllo DataGridView quando è necessario maggiore controllo sul layout dei dati. DataRepeater "ripete" un gruppo di controlli correlati mediante la creazione di più istanze in una visualizzazione a scorrimento. In tal modo gli utenti sono in grado di visualizzare più record contemporaneamente.

Panoramica

In fase di progettazione, il controllo DataRepeater è composto da due sezioni. La sezione esterna è il riquadro di visualizzazione, in cui in fase di esecuzione vengono visualizzati i dati di scorrimento. La sezione interna (superiore), nota come modello di elemento, è il punto in cui vengono posizionati i controlli che verranno ripetuti in fase di esecuzione, in genere un controllo per ciascun campo dell'origine dati. Le proprietà e i controlli del modello di elemento vengono incapsulati nella proprietà ItemTemplate.

In fase di esecuzione, la proprietà ItemTemplate viene copiata in un oggetto DataRepeaterItem virtuale, utilizzato per visualizzare i dati quando ciascun record viene scorso nella visualizzazione. È possibile personalizzare la visualizzazione di record singoli nell'evento DrawItem, ad esempio, evidenziando un campo in base al valore in esso contenuto. Per ulteriori informazioni, vedere la classe Procedura: modificare l'aspetto di un controllo DataRepeater (Visual Studio).

Il controllo DataRepeater viene generalmente utilizzato per visualizzare dati provenienti da una tabella di database o da un'altra origine dati associata. In aggiunta a oggetti dati ADO.NET, il controllo DataRepeater è in grado di eseguire l'associazione a qualsiasi classe che implementi le interfacce IList (matrici incluse), IListSource, IBindingList o IBindingListView.

Associazione dati

L'associazione dati si ottiene in genere trascinando campi dalla finestra Origini dati al controllo DataRepeater. Per ulteriori informazioni, vedere la classe Procedura: visualizzare i dati associati in un controllo DataRepeater (Visual Studio).

Quando si utilizzano grandi quantità di dati, è possibile impostare la proprietà VirtualMode su True per visualizzare un sottoinsieme dei dati disponibili. In modalità virtuale è richiesta l'implementazione di una cache di dati da cui popolare DataRepeater ed è necessario controllare in fase di esecuzione tutte le interazioni con la cache di dati. Per ulteriori informazioni, vedere la classe Modalità virtuale nel controllo DataRepeater (Visual Studio).

È inoltre possibile visualizzare controlli non associati in un controllo DataRepeater. Ad esempio, è possibile visualizzare un'immagine ripetuta su ciascun elemento. Per ulteriori informazioni, vedere la classe Procedura: visualizzare i controlli non associati in un controllo DataRepeater (Visual Studio).

Eventi

Gli eventi più importanti per il controllo DataRepeater sono l'evento DrawItem, generato quando vengono scorsi nuovi elementi nella visualizzazione, e l'evento CurrentItemIndexChanged, generato quando viene selezionato un elemento. È possibile utilizzare l'evento DrawItem per modificare l'aspetto dell'elemento. Ad esempio, è possibile evidenziare i valori negativi. Per accedere ai valori dei controlli quando viene selezionato un elemento, utilizzare l'evento CurrentItemIndexChanged.

Il controllo DataRepeater espone tutti gli eventi di controllo standard nell'editor di codice. Tuttavia, alcuni degli eventi non devono essere utilizzati. Eventi relativi a tastiera e mouse quali KeyDown, Click e MouseDown non verranno generati in fase di esecuzione, perché il controllo DataRepeater stesso non ha mai lo stato attivo.

L'oggetto DataRepeaterItem non espone eventi in fase di progettazione perché viene creato soltanto in fase di esecuzione. Per gestire eventi relativi a tastiera e mouse, è possibile aggiungere un controllo Panel a ItemTemplate in fase di progettazione e quindi gestire gli eventi per Panel. Per ulteriori informazioni, vedere la classe Risoluzione dei problemi relativi al controllo DataRepeater (Visual Studio).

Personalizzazioni

Esistono diversi modi per personalizzare l'aspetto e il comportamento del controllo DataRepeater, sia in fase di esecuzione che in fase di progettazione. L'impostazione delle proprietà consente di modificare i colori, nascondere o modificare le intestazioni di elementi, modificare l'orientamento da verticale a orizzontale e così via. Per ulteriori informazioni, vedere Procedura: modificare l'aspetto di un controllo DataRepeater (Visual Studio), Procedura: visualizzare le intestazioni degli elementi in un controllo DataRepeater (Visual Studio) e Procedura: modificare il layout di un controllo DataRepeater (Visual Studio).

Si noti che alcune proprietà sono valide per il controllo DataRepeater stesso mentre altre sono valide soltanto per ItemTemplate. Prima di impostare le proprietà, assicurarsi che sia stata selezionata la sezione corretta del controllo. Per ulteriori informazioni, vedere la classe Procedura: modificare l'aspetto di un controllo DataRepeater (Visual Studio).

Le altre personalizzazioni disponibili includono il controllo della possibilità di aggiungere o eliminare record, l'aggiunta di funzionalità di ricerca e la visualizzazione di dati correlati in formato master e dettaglio. Per ulteriori informazioni, vedere Procedura: disabilitare l'aggiunta e l'eliminazione di elementi DataRepeater (Visual Studio), Procedura: cercare dati in un controllo DataRepeater (Visual Studio) e Procedura: creare un form Master-Details mediante due controlli DataRepeater (Visual Studio).