Procedura dettagliata: creazione di un oggetto TableAdapter con più query

Articolo
08/11/2011

In questa procedura dettagliata viene creato un TableAdapter in un dataset mediante la Configurazione guidata origine dati. Nello specifico viene creata una seconda query nell'oggetto TableAdapter utilizzando la TableAdapter (query, configurazione guidata) all'interno di Progettazione DataSet.

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

Creazione di un nuovo progetto Applicazione Windows.
Creazione e configurazione di un'origine dati nell'applicazione compilando un dataset con la Configurazione guidata origine dati.
Apertura del nuovo dataset in Progettazione DataSet.
Aggiunta di query all'oggetto TableAdapter con la Configurazione guidata TableAdapter .

Prerequisiti

Per completare questa procedura dettagliata, è necessario quanto segue:

Accedere al database di esempio Northwind nella versione SQL Server o Access. Per ulteriori informazioni, vedere Procedura: installare database di esempio.

Creazione di una nuova applicazione Windows

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

Per creare un nuovo progetto di applicazione Windows

In Visual Studio, creare un nuovo progetto nel menu File.
Scegliere un linguaggio di programmazione nel riquadro Tipi progetto.
Selezionare Applicazione Windows nel riquadro Modelli.
Assegnare al progetto il nome TableAdapterQueriesWalkthrough, quindi scegliere OK.

Il progetto verrà aggiunto a Esplora soluzioni e nella finestra di progettazione verrà visualizzato un nuovo form.

Creazione di un'origine dati da database mediante un oggetto TableAdapter

Con questa procedura viene creata un'origine dati mediante la Configurazione guidata origine dati sulla base della 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 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 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.

Il dataset NorthwindDataSet viene aggiunto al progetto e la tabella Customers viene visualizzata nella finestra Origini dati.

Apertura del dataset in Progettazione DataSet

Per aprire il dataset in Progettazione DataSet

Fare clic con il pulsante destro del mouse su NorthwindDataset nella finestra Origini dati.
Scegliere Modifica il Dataset con la finestra di progettazione dal menu di scelta rapida.

Il dataset NorthwindDataset viene aperto in Progettazione DataSet.

Aggiunta di una seconda query all'oggetto CustomersTableAdapter

Nella procedura guidata viene creato il dataset con una tabella dati Customers e un CustomersTableAdapter. In questa sezione della procedura dettagliata viene aggiunta una seconda query al CustomersTableAdapter.

Per aggiungere una query al CustomersTableAdapter

Trascinare nella tabella Customers una Query dalla scheda DataSet della Casella degli strumenti.

Verrà visualizzata la TableAdapter (query, configurazione guidata).
Selezionare Usa istruzioni SQL e scegliere Avanti.
Selezionare SELECT che restituisce righe, quindi scegliere Avanti.
Aggiungere una clausola WHERE alla query in modo da ottenere quanto riportato di seguito.
```
SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
FROM Customers 
WHERE City = @City
```
Nota

Se si utilizza la versione Access di Northwind, sostituire il parametro @City con un punto interrogativo. (SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)
Nella pagina Scegliere i metodi per generare assegnare il nome FillByCity al metodo Riempi un DataTable.

Nota

In questa procedura dettagliata il metodo Restituisci un DataTable non viene utilizzato. Pertanto, sarà possibile deselezionare la casella di controllo o lasciare il nome predefinito.
Scegliere Avanti e completare la procedura guidata.

La query FillByCity viene aggiunta al CustomersTableAdapter.

Aggiunta di codice per l'esecuzione della query aggiuntiva nel form

Per eseguire la query

In Esplora soluzioni scegliere Form1, quindi fare clic su Progettazione visualizzazioni.
Trascinare il nodo Customers dalla finestra Origini dati in Form1.
Passare alla visualizzazione del codice selezionando Codice dal menu Visualizza.

Sostituire il codice nel gestore eventi Form1_Load con il seguente per eseguire la query FillByCity.

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

Esecuzione dell'applicazione

Per eseguire l'applicazione

Premere F5.
La griglia viene compilata con clienti con un valore City pari a Seattle.

Passaggi successivi

Per aggiungere funzionalità all'applicazione

Aggiungere un controllo TextBox e un controllo Button e passare il valore contenuto nella casella di testo alla query. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Aggiungere logica di convalida all'evento ColumnChanging o RowChanging delle tabelle dati del dataset. Per ulteriori informazioni, vedere Convalida dei dati nei dataset.

Vedere anche

Condividi tramite