Creare un controllo utente Windows Forms del .NET Framework che supporta il data binding complesso con ADO.NET

Annotazioni

La DataSet classe e le classi correlate sono tecnologie .NET Framework legacy dei primi anni '2000 che consentono alle applicazioni di lavorare con i dati in memoria mentre le app vengono disconnesse dal database. Le tecnologie sono particolarmente utili per le app che consentono agli utenti di modificare i dati e rendere persistenti le modifiche apportate al database. Sebbene i set di dati siano una tecnologia di successo comprovata, l'approccio consigliato per le nuove applicazioni .NET consiste nell'usare Entity Framework Core. Entity Framework offre un modo più naturale per usare i dati tabulari come modelli a oggetti e dispone di un'interfaccia di programmazione più semplice.

Quando si visualizzano dati nei moduli nelle applicazioni Windows, è possibile scegliere i controlli esistenti dalla casella degli strumenti. In alternativa, è possibile creare controlli personalizzati se l'applicazione richiede funzionalità non disponibili nei controlli standard. Questa procedura dettagliata illustra come creare un controllo che implementa ComplexBindingPropertiesAttribute. Controlli che implementano l'oggetto ComplexBindingPropertiesAttribute contengono le proprietà DataSource e DataMember, che possono essere associate ai dati. Tali controlli sono simili a un DataGridView o un ListBox.

Per altre informazioni sulla creazione di controlli, vedere Sviluppo di controlli Windows Form in fase di progettazione.

Quando si creano controlli da usare in scenari di data binding, è necessario implementare uno degli attributi di data binding seguenti:

Utilizzo degli attributi di data binding
Implementare il DefaultBindingPropertyAttribute su controlli semplici, come TextBox, che visualizzano una singola colonna (o proprietà) di dati. Per altre informazioni, vedere Creare un controllo utente di Windows Form che supporta il data binding semplice.
Implementare nei ComplexBindingPropertiesAttribute controlli, ad esempio DataGridView, che visualizzano elenchi (o tabelle) di dati. Questo processo è descritto in questa pagina dettagliata.
Implementare nei LookupBindingPropertiesAttribute controlli, come ComboBox, che visualizzano elenchi (o tabelle) di dati, ma devono anche presentare una singola colonna o proprietà. Per altre informazioni, vedere Creare un controllo utente Windows Form che supporta il data binding di ricerca.

Questa procedura dettagliata crea un controllo complesso che visualizza righe di dati da una tabella. In questo esempio viene utilizzata la Customers tabella del database di esempio Northwind. Il controllo utente complesso visualizzerà la tabella clienti in un DataGridView controllo personalizzato.

Durante questa procedura dettagliata si apprenderà come:

Aggiungere un nuovo controllo utente al progetto.
Progettare visivamente il controllo utente.
Implementare l'attributo ComplexBindingProperty .
Creare un set di dati con la Configurazione guidata origine dati.
Impostare la tabella Customers nella finestra Origini dati per usare il nuovo controllo complesso.
Aggiungere il nuovo controllo trascinandolo dalla finestra Origini dati in Form1.

Prerequisiti

Per completare questa esercitazione, sono necessari i carichi di lavoro sviluppo per desktop .NET e Archiviazione dati ed elaborazione dei dati installati in Visual Studio. Per installarli, aprire del programma di installazione di Visual Studio e scegliere Modifica (o Altre>Modifica) accanto alla versione di Visual Studio da modificare. Consulta per modificare Visual Studio.

Questa procedura dettagliata usa SQL Server Express LocalDB e il database di esempio Northwind.

Se SQL Server Express LocalDB non è disponibile, installarlo dalla pagina di download di SQL Server Express o tramite il programma di installazione di Visual Studio. Nel programma di installazione di Visual Studioè possibile installare SQL Server Express LocalDB come parte del carico di lavoro di archiviazione ed elaborazione dei dati o come singolo componente.
Installare il database di esempio Northwind seguendo questa procedura:
1. In Visual Studio, aprire la finestra Esplora oggetti di SQL Server. L'Esplora oggetti di SQL Server viene installato come parte del carico di lavoro Archiviazione dati ed elaborazione nel programma di installazione di Visual Studio. Espandere nodo SQL Server. Fare clic con il pulsante destro del mouse sull'istanza di LocalDB e selezionare Nuova query.
  
  Verrà visualizzata una finestra dell'editor di query.
2. Copia lo script Northwind Transact-SQL negli Appunti. Questo script T-SQL crea il database Northwind da zero e lo popola con i dati.
3. Incolla lo script T-SQL nell'editor di query e poi scegli il pulsante Esegui.
  
  Dopo un breve periodo di tempo, la query termina l'esecuzione e viene creato il database Northwind.

Creare un progetto di app Windows Form

Il primo passaggio consiste nel creare un progetto di app Windows Form per C# o Visual Basic. Denominare il progetto ComplexControlWalkthrough.

Aggiungere un controllo utente al progetto

Poiché questa procedura dettagliata crea un controllo complesso associabile a dati da un Controllo Utente, aggiungere un elemento Controllo Utente al progetto:

Scegliere Aggiungi controllo utente dal menu Progetto.
Digitare ComplexDataGridView nell'area Nome e quindi selezionare Aggiungi.

Il controllo ComplexDataGridView viene aggiunto a Esplora soluzioni e viene aperto nella finestra di progettazione.

Progettare il controllo ComplexDataGridView

Per aggiungere un DataGridView al controllo utente, trascinare un DataGridView dalla casella degli strumenti sulla superficie di progettazione del controllo utente.

Aggiungere l'attributo di data binding richiesto

Per controlli complessi che supportano il data binding, è possibile implementare :ComplexBindingPropertiesAttribute

Passare il controllo ComplexDataGridView alla visualizzazione codice. Scegliere Codice dal menu Visualizza.

Sostituire il codice in ComplexDataGridView con il codice seguente:

using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
    public partial class ComplexDataGridView : UserControl
    {
        public object DataSource
        {
            get{ return dataGridView1.DataSource; }
            set{ dataGridView1.DataSource = value; }
        }

        public string DataMember
        {
            get{ return dataGridView1.DataMember; }
            set{ dataGridView1.DataMember = value; }
        }

        public ComplexDataGridView()
        {
            InitializeComponent();
        }
    }
}

<System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>
Public Class ComplexDataGridView

    Public Property DataSource() As Object
        Get
            Return DataGridView1.DataSource
        End Get
        Set(ByVal value As Object)
            DataGridView1.DataSource = value
        End Set
    End Property

    Public Property DataMember() As String
        Get
            Return DataGridView1.DataMember
        End Get
        Set(ByVal value As String)
            DataGridView1.DataMember = value
        End Set
    End Property
End Class

Scegliere Compila soluzione dal menu Compila.

Creare un'origine dati dal tuo database

Usare la procedura guidata di configurazione dell'origine dati per creare un'origine dati basata sulla tabella nel database di esempio Northwind.

Per aprire la finestra Origini dati, scegliere Mostra origini dati dal menu Dati.
Nella finestra Origini dati selezionare Aggiungi nuova origine dati per avviare la configurazione guidata origine dati .
Selezionare Database nella pagina Scegliere un tipo di origine dati e quindi selezionare Avanti.
Nella pagina Scelta connessione dati eseguire una delle operazioni seguenti:
- Se nell'elenco a discesa è disponibile una connessione dati al database di esempio Northwind, selezionarla.
- Selezionare Nuova connessione per avviare la finestra di dialogo Aggiungi/Modifica connessione .
Se il database richiede una password, selezionare l'opzione per includere dati sensibili e quindi selezionare Avanti.
Nella pagina Salva stringa di connessione nel file di configurazione dell'applicazione fare clic su Avanti.
Nella pagina Scegliere gli oggetti di database espandere il nodo Tabelle .
Selezionare la Customers tabella e quindi selezionare Fine.

Il NorthwindDataSet viene aggiunto al progetto e la Customers tabella viene visualizzata nella finestra Origini dati .

Impostare la tabella Customers per usare il controllo ComplexDataGridView

Nella finestra Origini dati è possibile impostare il controllo da creare prima di trascinare gli elementi nel form:

Apri Form1 nell'editor.
Espandere il nodo Clienti nella finestra Origini dati .
Fare clic sulla freccia dell'elenco a discesa nel nodo Clienti e scegliere Personalizza.
Selezionare ComplexDataGridView dall'elenco controlli associati nella finestra di dialogo Opzioni di personalizzazione dell'interfaccia utente dati .
Fare clic sulla freccia dell'elenco a discesa nella Customers tabella e scegliere ComplexDataGridView dall'elenco dei controlli.

Aggiungere controlli al modulo

È possibile creare i controlli associati a dati trascinando gli elementi dalla finestra Origini dati nel form. Trascinare il nodo Clienti principale dalla finestra Origini dati nel form. Verificare che il controllo ComplexDataGridView venga usato per visualizzare i dati della tabella.

Eseguire l'applicazione

Premere F5 per eseguire l'applicazione.

Passaggi successivi

A seconda dei requisiti dell'applicazione, è possibile eseguire diversi passaggi dopo la creazione di un controllo che supporta l'associazione dati. Alcuni passaggi successivi tipici includono:

Inserimento dei controlli personalizzati in una libreria di controlli in modo da poterli riutilizzare in altre applicazioni.
Creazione di controlli che supportano scenari di ricerca. Per altre informazioni, vedere Creare un controllo utente Windows Form che supporta il data binding di ricerca.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2025-12-12