Procedura dettagliata: creazione di un controllo utente Windows Form che supporta l'associazione dati complessa

Articolo
02/09/2017

Data di pubblicazione: aprile 2016

Quando si visualizzano dati nei form delle applicazioni Windows, è possibile scegliere i controlli esistenti dalla Casella degli strumenti o creare controlli personalizzati se l'applicazione richiede funzionalità che non sono disponibili nei controlli standard. In questa procedura dettagliata è illustrato come creare un controllo che implementa ComplexBindingPropertiesAttribute. I controlli che implementano ComplexBindingPropertiesAttribute contengono DataSource e la proprietà DataMember che può essere associata ai dati. Tali controlli sono simili a DataGridView o ListBox.

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

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

Uso degli attributi di data binding
Implementare DefaultBindingPropertyAttribute su controlli semplici, ad esempio TextBox, che visualizzano una singola colonna, o proprietà, di dati. Per altre informazioni, vedere Procedura dettagliata: creazione di un controllo utente Windows Form che supporta l'associazione dati semplice.
Implementare ComplexBindingPropertiesAttribute su controlli, ad esempio DataGridView, che visualizzano elenchi, o tabelle, di dati. Il processo è descritto in questa pagina di procedura dettagliata.
Implementare LookupBindingPropertiesAttribute su controlli, ad esempio ComboBox, che visualizzano elenchi, o tabelle, di dati ma che devono anche presentare una singola colonna o proprietà. Per altre informazioni, vedere Procedura dettagliata: creazione di un controllo utente Windows Form che supporta l'associazione dati di ricerca.

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

Durante questa procedura dettagliata, si apprenderà come:

Creare una nuova applicazione Windows.
Aggiungere un nuovo controllo utente al progetto.
Progettare visivamente il controllo utente.
Implementare l'attributo ComplexBindingProperty.
Creare un dataset con Configurazione guidata origine dati.
Impostare la tabella Customers in Origini dati (finestra) per usare il nuovo controllo complesso.
Aggiungere il nuovo controllo trascinandolo dalla finestra Origini dati in Form1.

Prerequisiti

Per completare questa procedura dettagliata, è necessario:

Accedere al database di esempio Northwind. Per altre informazioni, vedere Procedura: installare database di esempio.

Creazione di un'applicazione Windows

Il primo passaggio consiste nella creazione di un'applicazione Windows.

Per creare il nuovo progetto Windows

In Visual Studio creare un nuovo Progetto dal menu File.
Assegnare al progetto il nome ComplexControlWalkthrough.
Selezionare Applicazione Windows e fare clic su OK. Per altre informazioni, vedere Applicazioni client.

Il progetto ComplexControlWalkthrough viene creato e aggiunto a Esplora soluzioni.

Aggiunta di un controllo utente al progetto

Dal momento che questa procedura dettagliata crea un controllo di data binding semplice da un Controllo utente, è necessario aggiungere un elemento Controllo utente al progetto.

Per aggiungere un controllo utente al progetto

Scegliere Aggiungi controllo utente dal menu Progetto .
Digitare ComplexDataGridView nell'area Nome, quindi fare clic su Aggiungi.

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

Progettazione del controllo ComplexDataGridView

Questo passaggio aggiunge un oggetto DataGridView al controllo utente.

Per progettare il controllo ComplexDataGridView

Trascinare un oggetto DataGridView dalla Casella degli strumenti nell'area di progettazione del controllo utente.

Aggiunta dell'attributo di data binding richiesto

Per controlli semplici che supportano il data binding, è possibile implementare l'attributo ComplexBindingPropertiesAttribute.

Per implementare l'attributo ComplexBindingProperties

Passare al controllo ComplexDataGridView per la visualizzazione del codice. Scegliere Codice dal menu Visualizza.

Sostituire il codice nel controllo ComplexDataGridView con la stringa 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.

Creazione di un'origine dati dal database

Questo passaggio usa la Configurazione guidata origine dati per creare un'origine dati basata sulla tabella Customers contenuta nel database di esempio Northwind. Per creare la connessione, è necessario avere accesso al database di esempio Northwind. Per informazioni sull'impostazione del database di esempio Northwind, vedere Procedura: installare database di esempio.

Per creare l'origine 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 scegliere Avanti.
Nella pagina Seleziona connessione dati eseguire una delle operazioni seguenti:
- Selezionare la connessione dati al database di esempio Northwind nell'elenco a discesa, se presente.
  
  -oppure-
- Selezionare Nuova connessione per aprire la finestra di dialogo Aggiungi/Modifica connessione.
Se il database in uso richiede una password, selezionare l'opzione che consente di includere dati riservati, quindi scegliere Avanti.
Nella pagina Salva stringa di connessione nel file di configurazione dell'applicazione fare clic su Avanti.
Espandere il nodo Tabelle nella pagina Seleziona oggetti di database.
Selezionare la tabella Customers, quindi fare clic su Fine.

L'oggetto NorthwindDataSet viene aggiunto al progetto e la tabella Customers viene visualizzata nella finestra Origini dati.

Impostazione della tabella Customers per usare il controllo ComplexDataGridView

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

Per impostare la tabella Customers allo scopo di associare il controllo ComplexDataGridView

Aprire Form1 nella finestra di progettazione.
Espandere il nodo Customers nella finestra Origini dati.
Fare clic sulla freccia a discesa nel nodo Customers e scegliere Personalizza.
Selezionare ComplexDataGridView dall'elenco Controlli associati nella finestra di dialogo Personalizzazione dell'interfaccia utente dati.
Fare clic sulla freccia a discesa nella tabella Customers e scegliere ComplexDataGridView dall'elenco di controllo.

Aggiunta di controlli al form

È possibile creare i controlli associati a dati trascinando elementi dalla finestra Origini dati nel form.

Per creare controlli associati a dati nel form

Trascinare il nodo Customers principale dalla finestra Origini dati nel form e verificare che il controllo ComplexDataGridView sia usato per visualizzare i dati della tabella.

Esecuzione dell'applicazione

Per eseguire l'applicazione

Premere F5 per eseguire l'applicazione.

Passaggi successivi

A seconda dei requisiti dell'applicazione, dopo la creazione di un controllo che supporta il data binding sarà possibile eseguire diverse operazioni. Ecco alcuni dei passaggi più comuni:

Posizionamento dei controlli personalizzati in una libreria di controlli in modo da poterli usare di nuovo in altre applicazioni.
Creazione di controlli che supportano scenari di ricerca. Per altre informazioni, vedere Procedura dettagliata: creazione di un controllo utente Windows Form che supporta l'associazione dati di ricerca.

Vedere anche

Impostare il controllo da creare durante il trascinamento dalla finestra Origini dati
Controlli per Windows Form
Associazione di controlli Windows Form ai dati in Visual Studio
Connessione ai dati in Visual Studio
Preparazione dell'applicazione al ricevimento di dati
Recupero di dati nell'applicazione
Associazione di controlli ai dati in Visual Studio
Modifica di dati nell'applicazione
Convalida dei dati
Salvataggio di dati

Condividi tramite