Procedura: creare e configurare adattatori dati manualmente

Articolo
09/12/2008

Aggiornamento: novembre 2007

È possibile creare gli adattatori dati senza utilizzare una procedura guidata. Le modifiche alla configurazione dell'adattatore possono essere apportate in qualsiasi momento, indipendentemente dal modo in cui è stato creato.

Nota:
Nella versione precedente di Visual Studio per le comunicazioni tra un'applicazione e un database venivano utilizzati degli adattatori dati. Mentre gli adattatori dati sono comunque un componente essenziale dei .Provider di dati .NET Framework (ADO.NET), gli oggetti TableAdapter sono componenti generati dalla finestra di progettazione che consentono di semplificare il processo di spostamento dei dati fra l'applicazione dell'utente e un database. Per ulteriori informazioni sull'utilizzo degli oggetti TableAdapter, vedere Cenni preliminari sugli oggetti TableAdapter.

Nella versione precedente di Visual Studio per le comunicazioni tra un'applicazione e un database venivano utilizzati degli adattatori dati. Mentre gli adattatori dati sono comunque un componente essenziale dei .Provider di dati .NET Framework (ADO.NET), gli oggetti TableAdapter sono componenti generati dalla finestra di progettazione che consentono di semplificare il processo di spostamento dei dati fra l'applicazione dell'utente e un database. Per ulteriori informazioni sull'utilizzo degli oggetti TableAdapter, vedere Cenni preliminari sugli oggetti TableAdapter.

Nota:
È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida in linea 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 Impostazioni di Visual Studio.

Per impostazione predefinita in Visual Studio il supporto in fase di progettazione per gli adattatori dati è stato disattivato. Per attivare il supporto per gli adattatori dati, è necessario aggiungerli alla Casella degli strumenti, come descritto nella prima procedura che segue.

Per aggiungere adattatori dati, connessioni e comandi alla Casella degli strumenti

Fare clic con il pulsante destro del mouse sulla Casella degli strumenti e fare clic su Scegli elementi.
Selezionare gli elementi da aggiungere nella scheda Componenti di .NET Framework della finestra di dialogo Scegli elementi della Casella degli strumenti. Per utilizzare il Provider di dati .NET Framework per SQL Server, ad esempio, selezionare SqlDataAdapter, SqlConnection e SqlCommand.
Scegliere OK per aggiungere gli elementi selezionati alla Casella degli strumenti.

Per creare manualmente un adattatore dati

Assicurarsi che nel form o nel componente utilizzato sia disponibile un oggetto connessione. Per informazioni dettagliate sull'aggiunta di una connessione autonoma, vedere Esecuzione della connessione (ADO.NET).
Dalla scheda Dati della Casella degli strumenti, trascinare un oggetto OleDbDataAdapter, SqlDataAdapter, OdbcDataAdapter o OracleDataAdapter nell'area di progettazione.

Nella finestra di progettazione viene aggiunta un'istanza dell'adattatore al form o al componente e viene avviata la Configurazione guidata adattatore dati.
Chiudere la procedura guidata.

Per configurare manualmente un adattatore dati

Selezionare l'adattatore, quindi configurare i comandi utilizzati per la lettura e l'aggiornamento dei dati nella finestra Proprietà. È necessario configurare l'oggetto SelectCommand. Se l'adattatore verrà utilizzato per aggiornare un'origine dati, sarà necessario configurare anche gli oggetti UpdateCommand, DeleteCommand e InsertCommand.

Per ciascun oggetto Command impostare le proprietà riportate di seguito.

Proprietà	Descrizione
ActiveConnection	Viene impostata per fare riferimento a un oggetto connessione. È possibile creare un oggetto connessione dalla proprietà ActiveConnection nella finestra Proprietà. In genere, ogni oggetto Command fa riferimento allo stesso oggetto connessione. Se l'applicazione lo richiede, sarà tuttavia possibile utilizzare connessioni diverse per ciascun comando.
CommandText	Rappresenta il testo di un'istruzione SQL o il nome di una stored procedure. Per alcuni provider è possibile includere nella proprietà CommandText più istruzioni o nomi di stored procedure, delimitati da punti e virgola (;). Le istruzioni o le stored procedure vengono eseguite in modo sequenziale. Questo risulta utile quando si esegue un'istruzione SELECT dopo un aggiornamento o un'istruzione INSERT per recuperare i record aggiornati e qualsiasi valore generato automaticamente, ad esempio i valori predefiniti o con incremento automatico.
CommandType	Rappresenta un valore che indica il modo in cui deve essere interpretato il valore della proprietà CommandText: Text: il comando è un'istruzione SQL. StoredProcedure: il comando è un riferimento a una stored procedure. TableDirect: il testo non è un comando, ma il nome di una tabella.
Parametri	Rappresenta un insieme di oggetti di tipo Parameter configurati per il passaggio di valori al comando. Nell'oggetto SelectCommand viene creato un insieme di parametri solo nel caso in cui il comando comprenda un segnaposto di parametro. Gli oggetti UpdateCommand, InsertCommand e DeleteCommand richiedono sempre dei parametri. Per informazioni dettagliate, vedere Procedura: configurare i parametri per gli adattatori dati.

Se non si desidera inserire nomi di colonne identici nell'origine dati e nel dataset, modificare i mapping. Il valore predefinito per la proprietà MissingMappingAction, Passthrough, determinerà la generazione automatica di nomi identici nell'origine dati e nel dataset. Per ulteriori informazioni, vedere Procedura: eseguire il mapping delle colonne dell'origine dati alle colonne delle tabelle dati di un dataset.

Scegliere Genera Dataset dal menu Dati.

Suggerimento:
Se il menu Dati non viene visualizzato, fare clic in un punto qualsiasi della finestra di progettazione del componente o del form. Il menu viene visualizzato solo se la finestra di progettazione è attiva.

Se si desidera visualizzare la modalità di riempimento di un dataset mediante un adattatore dati, visualizzare in anteprima i risultati. Per ulteriori informazioni, vedere Procedura: visualizzare in anteprima risultati degli adattatori dati.