Configurazione guidata adattatore dati

La Configurazione guidata adattatore dati facilita l'impostazione delle proprietà di un adattatore dati nuovo o esistente. Un adattatore dati contiene comandi SQL che possono essere utilizzati dall'applicazione per leggere dati da un database a un dataset e poi riscriverli nel database. La procedura guidata consente anche di creare facoltativamente una connessione dati per permettere all'adattatore di comunicare con un database.

La configurazione di un adattatore dati è una delle numerose operazioni legate all'utilizzo di un dataset nell'applicazione. Al termine della configurazione guidata sarà poi necessario aggiungere separatamente un dataset all'applicazione e scrivere il codice che permetterà all'adattatore dati di interagire con il dataset.

Esecuzione della procedura guidata

La Configurazione guidata può essere utilizzata per creare nuovi adattatori o modificare adattatori esistenti o può anche essere eseguita su un adattatore dati esistente per modificarne le proprietà.

Per eseguire la procedura guidata

1. Effettuare una delle seguenti operazioni:

   • Per creare un nuovo adattatore, trascinare un oggetto adattatore dalla Casella degli strumenti su un form o un componente.

   • Per modificare un adattatore esistente, selezionarlo nel form o nel componente e quindi selezionare Configura adattatore dati dal menu di scelta rapida.

   Verrà avviata la procedura guidata.

2. Specificare le informazioni per la connessione e il comando SQL. Per facilitare il compito, verranno visualizzate numerose finestre di dialogo:

   • Se si desidera creare una connessione, viene visualizzata la scheda Connessione della finestra di dialogo Finestra di dialogo Aggiungi/Modifica connessione (generale) che consente di specificare provider, nome del server, nome del database, nome utente e password per la connessione.

   • Per agevolare la creazione di istruzioni SQL, con la Configurazione guidata viene fornito il Generatore di query, un'utilità che consente di creare ed eseguire il test di un'istruzione Select utilizzando strumenti grafici. Per avviarla, fare clic sul pulsante Generatore di query quando viene chiesto di specificare un'istruzione SQL. Per ulteriori informazioni, vedere Strumenti di Progettazione query e Progettazione visualizzazioni.

     Suggerimento
     Se si intende creare stored procedure, fare clic su Anteprima script SQL per visualizzare lo script utilizzato dalla procedura guidata per effettuare questa creazione. Questo script può essere copiato e modificato per creare procedure personalizzate.

   Nota

   Selezionando Annulla all'interno della procedura guidata, l'adattatore verrà comunque creato, ma le relative proprietà non verranno impostate. Esse potranno essere impostate manualmente nella finestra Proprietà o si potrà eseguire nuovamente la Configurazione guidata.

Scopo della procedura guidata

La Configurazione guidata adattatore dati agevola l'intero processo di creazione di un adattatore dati e, se necessario, di una connessione dati. Le operazioni eseguite da questa procedura guidata sono:

• Creazione dell'adattatore.

• Eventuale creazione di una connessione dati e predisposizione dell'adattatore a utilizzarla.

• Creazione dell'istruzione SQL o delle stored procedure utilizzate per leggere e scrivere i dati.

• Creazione e configurazione dei parametri appropriati per le istruzioni SQL o le stored procedure per consentire ai comandi di leggere e scrivere i dati corretti.

• Esecuzione del mapping dei nomi di tabella e di colonne fra il database e il dataset.

Configurazione degli oggetti comando

La parte più significativa dell'attività svolta dalla procedura guidata consiste nella configurazione dei quattro oggetti comando utilizzati dall'adattatore per passare e ricevere dati dal database, Questi oggetti comprendono l'oggetto SelectCommand e, facoltativamente, gli oggetti UpdateCommand, InsertCommand e DeleteCommand. Ognuno di questi oggetti contiene un'istruzione SQL o il nome di una stored procedure utilizzata per leggere e scrivere i dati. Le proprietà di ciascuno di questi comandi, in particolare la proprietà CommandText, vengono impostate in base a scelte effettuate durante la procedura guidata.

La Configurazione guidata consente di utilizzare istruzioni SQL o stored procedure per i comandi. Vengono presentate le seguenti opzioni:

• Usa istruzioni SQL. È possibile specificare un'istruzione Select e, se si sceglie di crearle, vengono compilate anche le istruzioni Update, Insert e Delete corrispondenti sulla base di ciò che è stato incluso nell'istruzione Select. Le istruzioni Update e Insert comprendono i parametri per passare nuovi valori; inoltre, nelle istruzioni Update, Insert e Delete, all'interno di una clausola WHERE sono specificati i parametri per individuare il record corretto nel database.

• Crea nuove stored procedure. Questa opzione è simile alla precedente, con la differenza che vengono generate stored procedure anziché istruzioni. Poiché le stored procedure sono spesso più veloci delle istruzioni SQL, questa opzione può essere la scelta indicata per ottenere prestazioni migliori. In questo caso, vengono generate stored procedure per tutti e quattro i comandi, in base a ciò che è stato specificato per il comando Select. È possibile scegliere di scrivere nel database le nuove stored procedure. In caso contrario, si può comunque acquisire lo script SQL, che verrebbe utilizzato dalla Configurazione guidata per creare le stored procedure, ed eseguirlo manualmente in seguito.

• Usa stored procedure esistenti. Questa opzione consente di scegliere le stored procedure per ciascuno dei quattro comandi. Nella finestra della procedura guidata vengono visualizzati nomi e informazioni sulle stored procedure individuate nel database. Questa alternativa è utile se sono già disponibili stored procedure per l'esecuzione delle quattro operazioni su database.

Opzioni avanzate della procedura guidata

La Configurazione guidata prevede opzioni avanzate che consentono di controllare il modo in cui vengono creati i comandi Update, Insert e Delete per l'adattatore dati. La finestra di dialogo Opzioni avanzate generazione istruzioni SQL viene visualizzata selezionando Opzioni avanzate dal riquadro Genera istruzioni SQL della procedura guidata.

Questa finestra di dialogo consente di specificare le opzioni seguenti:

• Genera istruzioni Insert, Update e Delete. Consente di generare istruzioni o stored procedure aggiuntive basate sull'istruzione Select per scrivere dati nel database. Se l'adattatore verrà utilizzato soltanto per leggere dati e non per aggiornarli, è consigliabile deselezionare questa casella di controllo per ottenere prestazioni più efficienti.

• Usa concorrenza ottimistica. Consente di specificare che si desidera includere la logica necessaria per determinare se un record è cambiato successivamente a quando è stato letto dal database.

• Aggiorna DataSet. Consente di specificare che deve essere generato il codice per rileggere un record dal database dopo che questo è stato aggiornato. Il record che viene visualizzato risulta quindi aggiornato e comprende i valori inseriti dal database, quali i valori predefiniti e con incremento automatico.

Per ulteriori informazioni, vedere Finestra di dialogo Opzioni avanzate generazione istruzioni SQL.

Passaggi successivi

Al termine della procedura guidata, l'adattatore dati ed eventualmente la connessione vengono aggiunti al form. A questo punto è possibile eseguire una serie di operazioni: alcune di esse vengono eseguite quasi sempre, altre invece sono facoltative.

Possibili operazioni necessarie

Di seguito vengono descritte le operazioni che spesso vengono eseguite al termine della Configurazione guidata adattatore dati.

• Aggiunta di altri adattatori dati. Con la procedura guidata è possibile creare un singolo adattatore dati. Di norma, ciascun adattatore dati viene utilizzato per leggere e scrivere dati in un'unica tabella dati. Se si ha intenzione di utilizzare un dataset contenente più tabelle, è opportuno aggiungere altri adattatori dati al form o componente. Ogni volta che si aggiunge un adattatore dati dalla Casella degli strumenti, la procedura guidata viene eseguita nuovamente per configurarlo.

• Modifica dei mapping delle tabelle dell'adattatore. In base all'impostazione predefinita si presuppone che lettura e scrittura dei dati verranno eseguite dall'adattatore da e in tabelle e colonne con nomi identici. È tuttavia possibile utilizzare l'adattatore per leggere da un database che utilizza determinati nomi a un dataset che invece utilizza nomi diversi. Oppure è possibile che vengano lette dal database più colonne di quante ne occorrano nel dataset.

• Aggiunta di logica per la compilazione del dataset. Per compilare un dataset utilizzando l'adattatore dati, occorre chiamare il metodo Fill dell'adattatore. che consente di eseguire il comando nell'oggetto SelectCommand dell'adattatore e compilare il dataset con i risultati. Per ulteriori informazioni, vedere Compilazione di un DataSet da un oggetto DataAdapter (ADO.NET).

Vedere anche

Riferimenti

TableAdapter (configurazione guidata)

Concetti

Associazione di controlli ai dati in Visual Studio

Altre risorse

Cenni preliminari sulle applicazioni dati in Visual Studio

Connessione ai dati in Visual Studio

Preparazione dell'applicazione al ricevimento di dati

Recupero di dati nell'applicazione

Modifica di dati nell'applicazione

Convalida dei dati

Salvataggio di dati