Procedura dettagliata: riempimento di un dataset

Articolo
09/12/2008

Aggiornamento: novembre 2007

In questa procedura dettagliata viene creato un Dataset con una tabella dati e successivamente il Dataset viene riempito con i dati della tabella Customers del database di esempio Northwind. I dati vengono immessi nel database effettuando la chiamata al metodo Fill di un TableAdapter.

In particolare, vengono illustrate le seguenti operazioni:

Creazione di una nuova Applicazione Windows.
Creazione e configurazione un dataset mediante Configurazione guidata origine dati.
Creazione di un oggetto DataGridView con associazione a dati mediante il trascinamento dalla finestra Origini dati a un form.

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 il nuovo progetto Windows

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

Il progetto DatasetWalkthrough viene creato e aggiunto a Esplora soluzioni.

Creazione del dataset NorthwindDataSet

Questa procedura consente di creare un dataset mediante la Configurazione guidata origine dati in base alla tabella Customers del 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 il dataset

Scegliere Mostra origini dati dal menu Dati.
Nella finestra Origini dati fare clic su 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 effettuare una delle seguenti operazioni:
- Nell'elenco a discesa, selezionare la connessione dati al database di esempio Northwind, se presente.
  
  In alternativa
- 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, quindi scegliere Fine.

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

Aggiunta di controlli al form

È possibile creare controlli con associazione a dati mediante il trascinamento degli elementi dalla finestra Origini dati a un form dell'applicazione Windows in uso.

Per creare un DataGridView associato alla tabella Customers

Trascinare il nodo Customers principale dalla finestra Origini dati a Form1.

Sul form vengono visualizzati un controllo DataGridView 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.

Analisi del codice generato per l'inserimento dei dati nel dataset.

Mediante il trascinamento di elementi dalla finestra Origini dati a un form, nel gestore eventi Form1_Load viene aggiunto automaticamente il codice corretto per il riempimento del dataset.

Per caricare i dati in un dataset

In Esplora soluzioni selezionare Form1, quindi fare clic sul pulsante Visualizza codice.

Esaminare il gestore eventi Form1_Load. I dati vengono inseriti nel dataset tramite il metodo Fill del TableAdapter.

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

    'TODO: This line of code loads data into the 'NorthwindDataSet1.Customers' table.
    'You can move, or remove it, as needed.

    Me.CustomersTableAdapter1.Fill(Me.NorthwindDataSet1.Customers)
End Sub

private void Form1_Load(object sender, EventArgs e)
{
    // TODO: This line of code loads data into the 'northwindDataSet1.Customers' table.
    // You can move, or remove it, as needed.

    this.customersTableAdapter1.Fill(this.northwindDataSet1.Customers);
}

A scelta, è possibile copiare questo codice in altre parti dell'applicazione in uso in cui è necessario riempire il dataset.

Esecuzione dell'applicazione

Per eseguire l'applicazione

Premere F5 per eseguire l'applicazione.
Il dataset viene compilato con dati e visualizzato nell'oggetto DataGridView.

Passaggi successivi

A seconda dei requisiti dell'applicazione, sarà possibile eseguire diverse operazioni una volta terminata la creazione di un form con associazione a dati. È possibile apportare alcuni miglioramenti a questa procedura dettagliata, tra cui:

Aggiunta di una funzionalità di ricerca al form. Per ulteriori informazioni, vedere Procedura: aggiungere una query con parametri a un form in un'applicazione Windows.
Aggiunta di funzionalità per l'invio di aggiornamenti al database. Per ulteriori informazioni, vedere Procedura dettagliata: salvataggio di dati in un database (a tabella singola).
Aggiunta della tabella Orders al dataset selezionando Configura il Dataset con la procedura guidata dalla finestra Origini dati. Aggiunta di controlli in cui vengono visualizzati i dati correlati mediante il trascinamento del nodo Orders (al di sotto della colonna Fax all'interno della tabella Customers) nel form. Per ulteriori informazioni, vedere Procedura: visualizzare dati correlati in un'applicazione Windows.