Creare un controllo utente Windows Forms di .NET Framework che supporta l'associazione dati di ricerca

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 in Windows Form, è possibile scegliere i controlli esistenti dalla casella degli strumenti oppure creare controlli personalizzati se l'applicazione richiede funzionalità non disponibili nei controlli standard. Questa procedura dettagliata illustra come creare un controllo che implementa LookupBindingPropertiesAttribute. I controlli che implementano LookupBindingPropertiesAttribute possono contenere tre proprietà che possono essere associate ai dati. Tali controlli sono simili a .ComboBox

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. Per altre informazioni, vedere Creare un controllo utente di Windows Forms che supporta il data binding complesso.
Implementare nei LookupBindingPropertiesAttribute dei controlli, come un ComboBox che visualizzano elenchi (o tabelle) di dati, ma devono anche presentare una singola colonna o proprietà. Questo processo è descritto in questa pagina dettagliata.

In questa procedura dettagliata viene creato un controllo di ricerca che viene associato ai dati di due tabelle. In questo esempio vengono utilizzati le tabelle Customers e Orders del database di esempio Northwind. Il controllo di ricerca è associato al CustomerID campo della Orders tabella. Usa questo valore per cercare CompanyName nella tabella Customers.

Durante questa procedura dettagliata si apprenderà come:

Creare una nuova app Windows Forms (.NET Framework).
Aggiungere un nuovo controllo utente al progetto.
Progettare visivamente il controllo utente.
Implementare l'attributo LookupBindingProperty .
Creare un set di dati con il wizard Data Source Configuration.
Impostare la colonna CustomerID nella tabella Orders , nella finestra Origini dati , per usare il nuovo controllo.
Creare un modulo per visualizzare i dati nel nuovo controllo.

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 app Windows Forms (.NET Framework).

In Visual Studio scegliere Nuovo> dal menu File.
Espandere Visual C# o Visual Basic nel riquadro a sinistra, quindi selezionare Desktop di Windows.
Nel riquadro centrale selezionare il tipo di progetto App Windows Form .
Assegnare al progetto il nome LookupControlWalkthrough e quindi scegliere OK.

Il progetto LookupControlWalkthrough viene creato e aggiunto a Esplora soluzioni.

Aggiungere un controllo utente al progetto

Questa procedura dettagliata crea un controllo di ricerca da un Controllo utente, quindi aggiungere un elemento Controllo utente al progetto LookupControlWalkthrough.

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

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

Progettare il controllo LookupBox

Per progettare il controllo LookupBox, trascinare un ComboBox oggetto dalla casella degli strumenti nell'area di progettazione del controllo utente.

Aggiungere l'attributo di data binding richiesto

Per i controlli di ricerca che supportano il data binding, è possibile implementare .LookupBindingPropertiesAttribute

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

Sostituire il codice in LookupBox con il codice seguente:

using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")]
    public partial class LookupBox : UserControl
    {
        public object DataSource
        {
            get{ return comboBox1.DataSource; }
            set{ comboBox1.DataSource = value; }
        }

        public string DisplayMember
        {
            get{ return comboBox1.DisplayMember; }
            set{ comboBox1.DisplayMember = value; }
        }

        public string ValueMember
        {
            get{ return comboBox1.ValueMember; }
            set{ comboBox1.ValueMember = value; }
        }

        public string LookupMember
        {
            get{ return comboBox1.SelectedValue.ToString(); }
            set{ comboBox1.SelectedValue = value; }
        }


        public LookupBox()
        {
            InitializeComponent();
        }
    }
}

<System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")>
Public Class LookupBox

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

    Public Property DisplayMember() As String
        Get
            Return ComboBox1.DisplayMember
        End Get
        Set(ByVal value As String)
            ComboBox1.DisplayMember = value
        End Set
    End Property

    Public Property ValueMember() As String
        Get
            Return ComboBox1.ValueMember
        End Get
        Set(ByVal value As String)
            ComboBox1.ValueMember = value
        End Set
    End Property

    Public Property LookupMember() As String
        Get
            Return ComboBox1.SelectedValue.ToString()
        End Get
        Set(ByVal value As String)
            ComboBox1.SelectedValue = value
        End Set
    End Property
End Class

Scegliere Compila soluzione dal menu Compila.

Creare un'origine dati dal tuo database

Questo passaggio crea un'origine dati usando la procedura guidata Configurazione origine dati, in base alle tabelle Customers e Orders 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 le Customers tabelle e Orders e quindi selezionare Fine.

Il northwindDataSet viene aggiunto al progetto e le Customers tabelle e Orders vengono visualizzate nella finestra Origini dati .

Impostare la colonna CustomerID della tabella Orders per utilizzare il controllo LookupBox

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

Apri Form1 nell'editor.
Espandere il nodo Clienti nella finestra Origini dati .
Espandere il nodo Ordini (quello nel nodo Clienti sotto la colonna Fax ).
Fare clic sulla freccia dell'elenco a discesa nel nodo Ordini e scegliere Dettagli dall'elenco di controlli.
Fare clic sulla freccia dell'elenco a discesa nella colonna CustomerID (nel nodo Ordini ) e scegliere Personalizza.
Selezionare LookupBox dall'elenco Controlli associati nella finestra di dialogo Opzioni di personalizzazione dell'interfaccia utente dati .
Fare clic su OK.
Fare clic sulla freccia dell'elenco a discesa nella colonna CustomerID e scegliere LookupBox.

Aggiungere controlli al modulo

È possibile creare i controlli associati a dati trascinando gli elementi dalla finestra Origini dati in Form1.

Per creare controlli associati a dati in Windows Form, trascinare il nodo Orders dalla finestra Origini dati in Windows Form e verificare che il controllo LookupBox venga utilizzato per visualizzare i dati nella CustomerID colonna.

Associare il controllo per cercare CompanyName dalla tabella Customers

Per configurare le associazioni di ricerca, selezionare il nodo Clienti principale nella finestra Origini dati e trascinarlo nella casella combinata in CustomerIDLookupBox in Form1.

In questo modo viene configurato il data binding per visualizzare l'oggetto CompanyName dalla Customers tabella, mantenendo il CustomerID valore della Orders tabella.

Eseguire l'applicazione

Premere F5 per eseguire l'applicazione.
Navigare tra alcuni record e verificare che CompanyName venga visualizzato nel controllo LookupBox.

Associare i controlli Windows Forms ai dati in Visual Studio

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2025-12-12