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

Articolo
09/12/2015

Uno degli scenari più comuni nello sviluppo di applicazioni è la visualizzazione di dati in un form in un'applicazione Windows, la modifica dei dati e l'invio dei dati aggiornati 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 usata la tabella Customers del database di esempio Northwind.

È possibile salvare nel database i dati dell'applicazione chiamando il metodo Update di un oggetto TableAdapter. Quando si trascinano elementi dalla finestra Origini dati, il codice per salvare i dati viene automaticamente aggiunto per la prima tabella rilasciata in un form. Eventuali altre tabelle aggiunte a un form richiedono l'aggiunta manuale del 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).

Le attività illustrate nella procedura dettagliata sono le seguenti:

Creazione di un nuovo progetto Applicazione Windows.
Creazione e configurazione di un'origine dati nell'applicazione con la Configurazione guidata origine dati.
Impostazione dei controlli degli elementi nella Origini dati (finestra). Per altre informazioni, vedere Procedura: impostare il controllo da creare per il trascinamento dalla finestra Origini dati.
Creazione di controlli associati a dati con il trascinamento di elementi dalla finestra Origini dati nel form.
Modifica di alcuni record nel set di dati.
Aggiunta del codice per inviare nuovamente al database i dati aggiornati nel set di dati.

Nota

Le finestre di dialogo e i comandi di menu visualizzati potrebbero essere 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 altre informazioni, vedere Customizing Development Settings in Visual Studio.

Prerequisiti

Per completare questa procedura dettagliata, è necessario:

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

Creazione dell'applicazione Windows

Il primo passaggio consiste nella creazione di un'applicazione Windows. L'assegnazione di un nome al progetto è facoltativa in questo passaggio, ma al progetto verrà ugualmente assegnato un nome per poterlo salvare in seguito.

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

Il progetto UpdateSingleTableWalkthrough viene creato e aggiunto in Esplora soluzioni.

Creazione dell'origine dati

Questo passaggio consente di creare un'origine dati dal database Northwind usando la Configurazione guidata origine dati. Per completare la procedura guidata, è 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 l'origine dati

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.

Impostazione dei controlli da creare

Per questa procedura dettagliata i dati verranno visualizzati in singoli controlli nel layout Dettagli invece del layout predefinito DataGridView.

Per impostare i controlli per gli elementi della finestra Origini dati

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

Creazione del form associato a dati

È possibile creare i controlli associati a dati trascinando elementi dalla finestra Origini dati nel form.

Per creare controlli associati a dati nel form

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

Il form mostra i controlli associati 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.

Modifica del codice per aggiornare il database

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

Per aggiungere la logica di aggiornamento all'applicazione

Fare doppio clic sul pulsante Salva in BindingNavigator per aprire l'editor del codice per il gestore eventi bindingNavigatorSaveItem_Click.

Sostituire il codice nel gestore eventi per aggiungere alcune funzionalità di gestione degli errori. Il codice dovrebbe essere simile 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.
Fare clic sul 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 altre informazioni, vedere Procedura: aggiungere una query con parametri a un'applicazione Windows Form.
Aggiunta di controlli per la visualizzazione di dati correlati. Per altre informazioni, vedere Procedura: visualizzare dati correlati in un'applicazione Windows Form.
Modifica dell'origine dati per aggiungere o rimuovere oggetti di database. Per altre informazioni, vedere Procedura: modificare un dataset.