Procedura dettagliata: creazione di un controllo utente che supporta l'associazione dati semplice

Articolo
09/12/2008

Aggiornamento: novembre 2007

Durante la visualizzazione di dati sui form nelle applicazioni Windows, è possibile scegliere i controlli esistenti dalla Casella degli strumenti oppure creare controlli personalizzati se l'applicazione richiede delle funzionalità non disponibili nei controlli standard. In questa procedura dettagliata viene illustrato come creare un controllo che implementa l'oggetto DefaultBindingPropertyAttribute. Nei controlli che implementano l'oggetto DefaultBindingPropertyAttribute può essere contenuta una proprietà per l'associazione a dati. Questo tipo di controlli sono simili a un oggetto TextBox oppure CheckBox.

Per ulteriori informazioni sulla modifica di controlli, vedere Sviluppo di controlli Windows Form in fase di progettazione.

Durante la modifica dei controlli da utilizzare in scenari di associazione dati, è necessario implementare uno degli attributi di associazione dati riportati di seguito.

Utilizzo di attributi di associazione dati
Implementare l'oggetto DefaultBindingPropertyAttribute su controlli semplici, ad esempio un oggetto TextBox, nei quali viene visualizzata una singola colonna (oppure una proprietà) di dati. Il processo è descritto nella pagina di questa procedura dettagliata.
Implementare l'oggetto ComplexBindingPropertiesAttribute sui controlli, ad esempio un oggetto DataGridView, nei quali vengono visualizzati elenchi (oppure tabelle) di dati. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un controllo utente che supporta l'associazioni ai dati complessa.
Implementare l'oggetto LookupBindingPropertiesAttribute sui controlli, ad esempio ComboBox, nei quali vengono visualizzati elenchi (oppure tabelle) di dati, ma devono presentare una colonna oppure una proprietà singole. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un controllo utente che supporta l'associazione ai dati di ricerca.

Questa procedura dettagliata consente di creare un controllo semplice in cui sono visualizzati i dati di una singola colonna di una tabella. In questo esempio viene utilizzata la colonna Phone della tabella Customers dal database di esempio Northwind. Nel controllo utente semplice saranno visualizzati i numeri di telefono del cliente in un formato di numero telefonico standard utilizzando un oggetto MaskedTextBox e impostando la maschera su un numero di telefono.

In particolare, vengono illustrate le seguenti operazioni:

Creazione di una nuova Applicazione Windows.
Aggiunta di un nuovo Controllo utente al progetto.
Progettazione visiva del controllo utente.
Implementazione dell'attributo DefaultBindingProperty.
Creazione di un dataset con la Configurazione guidata origine dati.
Impostazione della colonna Telefono della finestra Origini dati per l'utilizzo del nuovo controllo.
Creazione di un form per visualizzare i dati nel nuovo controllo.

Prerequisiti

Per completare questa procedura dettagliata è necessario:

Accesso al database di esempio Northwind. Per ulteriori informazioni, vedere Procedura: installare database di esempio.

Creazione di un'applicazione Windows

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

Per creare un nuovo progetto Windows

In Visual Studio scegliere Progetto dal menu File.
Denominare il progetto SimpleControlWalkthrough.
Selezionare Applicazione Windows e scegliere OK. Per ulteriori informazioni, vedere Creazione di applicazioni per Windows.

Il progetto SimpleControlWalkthrough viene creato e aggiunto a Esplora soluzioni.

Aggiunta di un controllo utente al progetto

Questa procedura guidata consente la creazione di un controllo associabile a dati semplice da un Controllo utente, quindi l'aggiunta di un elemento Controllo utente al progetto SimpleControlWalkthrough.

Per aggiungere un controllo utente al progetto

Scegliere Aggiungi controllo utente dal menu Progetto.
Digitare PhoneNumberBox nell'area Nome e fare clic su Aggiungi.

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

Progettazione del controllo PhoneNumberBox

Questa procedura dettagliata estende l'oggetto MaskedTextBox esistente per creare il controllo PhoneNumberBox.

Per progettare il controllo PhoneNumberBox

Trascinare un oggetto MaskedTextBox dalla Casella degli strumenti all'area di progettazione del controllo utente.
Selezionare lo smart tag sull'oggetto MaskedTextBox appena trascinato e scegliere Imposta maschera.
Selezionare Numero di telefono nella finestra di dialogo Maschera input e scegliere OK per impostare la maschera.

‎Aggiunta dell'attributo di associazione dati richiesto.

Per controlli semplici che supportano l'associazione dati, implementare l'attributo DefaultBindingPropertyAttribute.

Per implementare l'attributo DefaultBindingProperty

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

Sostituire il codice nel controllo PhoneNumberBox con la stringa seguente:

<System.ComponentModel.DefaultBindingProperty("PhoneNumber")> _
Public Class PhoneNumberBox

    Public Property PhoneNumber() As String
        Get
            Return MaskedTextBox1.Text
        End Get
        Set(ByVal value As String)
            MaskedTextBox1.Text = value
        End Set
    End Property
End Class

using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.DefaultBindingProperty("PhoneNumber")]
    public partial class PhoneNumberBox : UserControl
    {
        public string PhoneNumber
        {
            get{ return maskedTextBox1.Text; }
            set{ maskedTextBox1.Text = value; }
        }

        public PhoneNumberBox()
        {
            InitializeComponent();
        }
    }
}

Scegliere Genera soluzione dal menu Genera.

Creazione di un'origine dati dal database in uso

In questa procedura viene utilizzata 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 disporre dell'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, quindi scegliere Avanti.
Nella pagina Seleziona connessione dati effettuare una delle seguenti operazioni:
- Nell'elenco a discesa, selezionare la connessione dati al database di esempio Northwind, se presente.
  
  Oppure
- Selezionare Nuova connessione per aprire la finestra di dialogo Aggiungi/Modifica connessione. Per ulteriori informazioni, vedere Finestra di dialogo Aggiungi/Modifica connessione (generale).
Se il database in uso richiede una password, selezionare l'opzione che consente di includere dati riservati e fare clic su Avanti.
Fare clic su Avanti nella pagina Salva la stringa di connessione nel file di configurazione dell'applicazione.
Espandere il nodo Tabelle nella pagina Seleziona oggetti di database.
Selezionare la tabella Customers e scegliere Fine.

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

Impostazione della colonna Telefono per l'utilizzo del controllo PhoneNumberBox

Nella finestra Origini dati è possibile impostare il controllo da creare prima dell'operazione di trascinamento degli elementi nel form in uso.

Per impostare la colonna Telefono da associare al controllo PhoneNumberBox

Aprire Form1 nella finestra di progettazione.
Espandere il nodo Customers nella finestra Origini dati.
Fare clic sulla freccia a discesa del nodo Customers e scegliere Dettagli dall'elenco dei controlli.
Fare clic sulla freccia a discesa sulla colonna Telefono e scegliere Personalizza.
Selezionare PhoneNumberBox dall'elenco dei controlli associati nella finestra di dialogo relativa alle opzioni di Personalizzazione dell'interfaccia utente dati.
Fare clic sulla freccia a discesa sulla colonna Telefono e scegliere PhoneNumberBox.

Aggiunta di controlli al form

È possibile creare i controlli con associazione a dati mediante il trascinamento degli elementi dalla finestra Origini dati al form.

Per creare controlli con associazione a dati nel form

Trascinare il nodo Customers principale dalla finestra Origini dati al form e verificare che sia utilizzato il controllo PhoneNumberBox per la visualizzazione dei dati nella colonna Phone.

Nel form vengono visualizzati i controlli con associazione a dati con etichette descrittive e un controllo Toolstrip (BindingNavigator) per lo spostamento all'interno dei record. Nella barra dei componenti vengono visualizzati gli oggetti NorthwindDataSet, CustomersTableAdapter BindingSource e BindingNavigator.

Esecuzione dell'applicazione

Per eseguire l'applicazione

Premere F5 per eseguire l'applicazione.

Passaggi successivi

A seconda dei requisiti dell'applicazione, è possibile eseguire diverse operazioni una volta terminata la creazione di un controllo che supporta le associazioni di dati. Tra le operazioni successive più comuni sono incluse le seguenti:

Posizionamento dei controlli personalizzati in una libreria di controlli che consente di utilizzarli nuovamente in applicazioni successive. Per ulteriori informazioni, vedere Modello di libreria di controlli Windows.
Creazione di controlli che supportano scenari di associazioni di dati più complessi. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un controllo utente che supporta l'associazioni ai dati complessa e Procedura dettagliata: creazione di un controllo utente che supporta l'associazione ai dati di ricerca.

Vedere anche

Condividi tramite