Procedura dettagliata: salvataggio di dati in un database (a tabella singola)

Articolo
08/11/2011

In uno degli scenari più comuni nello sviluppo delle applicazioni i dati vengono prima visualizzati in un form di un'applicazione Windows, quindi modificati e infine, così aggiornati, inviati nuovamente al database. Questa procedura dettagliata consente di creare un form semplice in cui vengono visualizzati i dati di una tabella in singoli controlli. È possibile modificare i dati nei controlli e salvare le modifiche nel database. In questo esempio viene utilizzata la tabella Customers del database di esempio Northwind.

I dati dell'applicazione possono essere nuovamente salvati nel database chiamando il metodo Update di un oggetto TableAdapter. Quando si trascinano degli elementi dalla finestra Origini dati, viene automaticamente aggiunto il codice per salvare i dati per la prima tabella trascinata sul form. Per tutte le altre tabelle aggiunte al form occorrerà aggiungere manualmente il codice necessario per salvare i dati. Per informazioni sul salvataggio dei dati da più tabelle, vedere Procedura dettagliata: salvataggio di dati in un database (a più tabelle).

Di seguito sono elencate le attività illustrate nella procedura dettagliata:

Creazione di un nuovo progetto Applicazione Windows.
Creazione e configurazione di un'origine dati in un'applicazione utilizzando la Configurazione guidata origine dati.
Impostare i controlli degli elementi nella Origini dati (finestra). Per ulteriori informazioni, vedere Procedura: impostare il controllo da creare per il trascinamento dalla finestra Origini dati.
Creazione dei controlli associati a dati mediante il trascinamento degli elementi dalla finestra Origini dati nel form.
Modifica di un paio di record del dataset.
Aggiunta di codice per inviare al database i dati aggiornati nel dataset.

Nota

È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Gestione delle impostazioni.

Prerequisiti

Per completare questa procedura dettagliata è necessario:

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

Creazione dell'applicazione Windows

Il primo passaggio consiste nella creazione di un'Applicazione Windows. Sebbene in questo passaggio l'assegnazione di un nome al progetto sia facoltativa, si procederà comunque alla specifica di un nome in quanto è previsto che il progetto venga salvato in un secondo momento.

Per creare il nuovo progetto Applicazione Windows

Scegliere il comando per la creazione di un nuovo progetto dal menu File.
Assegnare al progetto il nome UpdateSingleTableWalkthrough.
Selezionare Applicazione Windows e scegliere OK. Per ulteriori informazioni, vedere Creazione di applicazioni per Windows.

Il progetto UpdateSingleTableWalkthrough verrà creato e aggiunto a Esplora soluzioni.

Creazione dell'origine dati

In questo passaggio verrà creata un'origine dati dal database Northwind utilizzando la Configurazione guidata origine dati. Per completare la procedura guidata è 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 scegliere 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:
- 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. 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, quindi scegliere Avanti.
Scegliere 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.

Impostazione dei controlli da creare

In questa procedura dettagliata i dati saranno presentati in un layout Dettagli, ossia saranno visualizzati in singoli controlli differenti, anziché nel layout predefinito DataGridView.

Per impostare i controlli degli elementi della finestra Origini dati

Espandere il nodo Customers nella finestra Origini dati.
Impostare il controllo della tabella Customers sui singoli controlli selezionando Dettagli dall'elenco a discesa del nodo Customers. Per ulteriori informazioni, vedere Procedura: impostare il controllo da creare per il trascinamento dalla finestra Origini dati.

Creazione del form con associazione a dati

È 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 in Form1.

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. Sulla barra dei componenti vengono visualizzati gli oggetti NorthwindDataSet, CustomersTableAdapter BindingSource e BindingNavigator.

Modifica del codice per aggiornare il database

È possibile aggiornare il database chiamando il metodo Update dell'oggetto CustomersTableAdapter. Per impostazione predefinita, al codice del form viene aggiunto un gestore eventi per il pulsante Salva del controllo BindingNavigator che consente di inviare gli aggiornamenti al database. In questa procedura il codice verrà modificato per includere la gestione degli errori eseguendo il wrapping della chiamata di aggiornamento in un blocco try-catch. È possibile modificare il codice per adattarlo alle esigenze dell'applicazione.

Per aggiungere logica di aggiornamento all'applicazione

Fare doppio clic sul pulsante Salva dell'oggetto BindingNavigator per aprire l'editor di codice nel gestore eventi bindingNavigatorSaveItem_Click.

Sostituire il codice nel gestore eventi per aggiungere una gestione degli errori. Il codice dovrebbe essere analogo al seguente:

Try
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
    MsgBox("Update successful")

Catch ex As Exception
    MsgBox("Update failed")
End Try

try
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.customersTableAdapter.Update(this.northwindDataSet.Customers);
    MessageBox.Show("Update successful");
}
catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

Verifica dell'applicazione

Per eseguire il test dell'applicazione

Premere F5.
Apportare alcune modifiche ai dati di uno o più record.
Scegliere il pulsante Salva.
Controllare i valori presenti nel database per verificare che le modifiche siano state salvate.

Passaggi successivi

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

Aggiunta di funzionalità di ricerca al form. Per ulteriori informazioni, vedere Procedura: aggiungere una query con parametri a un'applicazione Windows Form.
Aggiunta di controlli per la visualizzazione dei dati correlati. Per ulteriori informazioni, vedere Procedura: visualizzare dati correlati in un'applicazione Windows Form.
Modifica dell'origine dati per aggiungere o rimuovere oggetti di database. Per ulteriori informazioni, vedere Procedura: modificare un dataset.