Procedura dettagliata: riempimento di un dataset

Articolo
06/14/2015

Questa procedura dettagliata crea un set di dati con una tabella dati e vi inserisce i dati dalla tabella Customers del database di esempio Northwind. I dati sono inseriti nel set di dati tramite la chiamata al metodo Fill di TableAdapter.

Durante questa procedura dettagliata, si apprenderà come:

Creare una nuova applicazione Windows.
Creare e configurare un set di dati con la Configurazione guidata origine dati.
Creare un oggetto DataGridView con associazione a dati mediante il trascinamento dalla finestra Origini dati in un form.

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 DatasetWalkthrough.
Selezionare Applicazione Windows e fare clic su OK. Per altre informazioni, vedere Sviluppo di applicazioni client con .NET Framework.

Il progetto DatasetWalkthrough viene creato e aggiunto a Esplora soluzioni.

Creazione di NorthwindDataSet

Questo passaggio crea un set di dati usando la Configurazione guidata origine dati basata sulla tabella Customers 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 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 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.

Aggiunta di controlli al form

È possibile creare controlli associati a dati trascinando gli elementi dalla finestra Origini dati in un form nell'applicazione Windows.

Per creare un oggetto DataGridView associato alla tabella Customers

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

Nel 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.

Verifica del codice generato che inserisce i dati nel set di dati

Se si trascinano elementi dalla finestra Origini dati in un form, il codice corretto per l'inserimento di dati nel set di dati sarà aggiunto automaticamente al gestore eventi Form1_Load.

Per caricare dati in un set di dati

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

Verificare il gestore eventi Form1_Load. Il metodo Fill di TableAdapter inserisce i dati nel set di dati.

Private Sub Form1_Load() 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);
}

È facoltativamente possibile copiare questo codice in altre parti dell'applicazione in cui è necessario inserire dati nel set di dati.

Esecuzione dell'applicazione

Per eseguire l'applicazione

Premere F5 per eseguire l'applicazione.
I dati saranno inseriti nel set di dati e il set di dati sarà visualizzato in DataGridView.

Passaggi successivi

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

Aggiunta di funzionalità di ricerca al form. Per altre informazioni, vedere Procedura: aggiungere una query con parametri a un'applicazione Windows Form.
Aggiunta di funzionalità di reinvio di aggiornamenti al database. Per altre informazioni, vedere Procedura dettagliata: salvataggio di dati in un database (a tabella singola).
Aggiunta della tabella Orders al set di dati selezionando Configura il Dataset con la procedura guidata nella finestra Origini dati. Aggiungere quindi i controlli che visualizzano dati correlati trascinando il nodo correlato Orders (posto sotto la colonna Fax nella tabella Customers) nel form. Per altre informazioni, vedere Procedura: visualizzare dati correlati in un'applicazione Windows Form.