Configurazione guidata TableAdapter

Articolo
09/12/2008

Aggiornamento: novembre 2007

La Configurazione guidata TableAdapter consente di creare e modificare gli oggetti TableAdapter. I TableAdapter creati si basano su istruzioni SQL immesse o su stored procedure esistenti nel database. La procedura guidata consente inoltre di creare nuove stored procedure nel database basate sulle istruzioni SQL immesse nella procedura guidata.

Un oggetto TableAdapter effettua la connessione a un database nel quale esegue query o stored procedure e consente di compilare un oggetto DataTable con i dati restituiti dalla query o dalla stored procedure. Oltre a inserire dei dati nelle tabelle dati esistenti, i TableAdapter possono restituire nuove tabelle che già contengono dati. Per ulteriori informazioni, vedere Cenni preliminari sugli oggetti TableAdapter.

Esecuzione della procedura guidata

Eseguire la procedura guidata per la creazione o la modifica di TableAdapter e delle DataTable associate. Per ulteriori informazioni, vedere Procedura: avviare la Configurazione guidata TableAdapter.

Seleziona connessione dati

Scegliere una connessione esistente dall'elenco di connessioni disponibili oppure fare clic su Nuova connessione per aprire la Finestra di dialogo Aggiungi/Modifica connessione (generale) e creare una connessione al database.

Dopo aver compilato la finestra di dialogo Proprietà connessione, nell'area Dettagli connessione vengono visualizzate le informazioni di sola lettura sul provider selezionato oltre alla stringa di connessione.

Salva stringa di connessione nel file di configurazione dell'applicazione

Scegliere Sì, salva la connessione con nome per archiviare la stringa di connessione nel file di configurazione dell'applicazione. Digitare un nome da assegnare alla connessione oppure utilizzare quello predefinito.

Il salvataggio delle stringhe di connessione nel file di configurazione dell'applicazione semplifica il processo di gestione dell'applicazione se la connessione al database viene modificata. Qualora vengano apportate modifiche nella connessione al database, è possibile modificare la stringa di connessione nel file di configurazione dell'applicazione, evitando in tal modo di dover modificare il codice sorgente e ricompilare l'applicazione. Per informazioni sulla modifica di una stringa di connessione nel file di configurazione dell'applicazione, vedere Procedura: modificare una stringa di connessione.

Nota sulla sicurezza:
Le informazioni vengono archiviate nel file di configurazione dell'applicazione come testo normale. Per ridurre la possibilità di un accesso non autorizzato a informazioni riservate, è possibile crittografare i dati. Per ulteriori informazioni, vedere Crittografia e decrittografia di dati.

Seleziona un tipo di comando

Scegliere il tipo di comando da eseguire nel database.

Nella pagina Seleziona un tipo di comando effettuare la selezione di uno dei seguenti metodi di recupero dei dati dal database:

Usa istruzioni SQL consente di digitare un'istruzione SQL per selezionare i dati dal database.
Crea nuove stored procedure: selezionando questa opzione è possibile utilizzare la procedura guidata per la creazione di nuove stored procedure (nel database) in base all'istruzione SELECT specificata.
Usa stored procedure esistenti: selezionando questa opzione è possibile eseguire il mapping delle stored procedure che già esistono nel database nei comandi SELECT, INSERT, UPDATE e DELETE del TableAdapter.

Usa istruzioni SQL

In questa sezione viene illustrato come completare la Configurazione guidata TableAdapter quando è selezionata l'opzione Usa istruzioni SQL.

Nella pagina Genera le istruzioni SQL digitare l'istruzione SQL la cui esecuzione determina la compilazione della tabella con dati.

Nota:
La procedura guidata consente di accedere al Generatore di query, uno strumento visivo per la creazione di query SQL. Per aprirlo, fare clic sul pulsante Generatore di query. Per ulteriori informazioni sull'utilizzo del Generatore di query, vedere Strumenti di Progettazione query e Progettazione visualizzazioni.

Scegliere i metodi per generare

In questa pagina sono fornite le opzioni per la selezione dei metodi di TableAdapter generati dalla procedura per il recupero e l'aggiornamento dei dati.

Riempi un DataTable
Consente di creare il metodo predefinito di TableAdapter per la compilazione della tabella di dati. Quando si chiama questo metodo, passare come parametro il nome della tabella dati.

È anche possibile modificare il nome predefinito nella casella Nome metodo.
Restituisci un DataTable
Consente di creare il metodo di TableAdapter per la restituzione di una tabella di dati compilata. In alcune applicazioni è preferibile restituire una tabella di dati compilata piuttosto che riempire con dati la tabella esistente.

È anche possibile modificare il nome predefinito nella casella Nome metodo.

Crea metodi per inviare aggiornamenti direttamente al database
Consente di creare i comandi INSERT, UPDATE e DELETE necessari per la scrittura delle modifiche nel database sottostante. La selezione di questa casella equivale a impostare la proprietà GenerateDBDirectMethods su vero.

Nota:
Questa opzione non è disponibile se l'istruzione SQL originale non fornisce informazioni sufficienti o se la query non è aggiornabile. Questa situazione può verificarsi ad esempio nel caso delle query JOIN e delle query che restituiscono un singolo valore (scalare).

Crea nuove stored procedure

In questa sezione viene illustrato come completare la Configurazione guidata TableAdapter quando è selezionata l'opzione Crea nuove stored procedure.

Nella pagina Genera le stored procedure digitare l'istruzione SQL che consente di riempire la tabella dati. Si tratta dell'istruzione SELECT di TableAdapter, alla base della creazione di stored procedure per la selezione, l'aggiornamento, l'inserimento e l'eliminazione dei dati.

Nota:
La procedura guidata consente di accedere al Generatore di query, uno strumento visivo per la creazione di query SQL. Per aprirlo, fare clic sul pulsante Generatore di query. Per ulteriori informazioni sull'utilizzo del Generatore di query, vedere Strumenti di Progettazione query e Progettazione visualizzazioni oppure premere F1 nella finestra di dialogo.

Nella pagina Crea le stored procedure effettuare le seguenti operazioni:

Digitare un nome per la nuova stored procedure.

Specificare se creare la stored procedure nel database sottostante.

Nota:
La capacità di creare stored procedure nel database dipende dalle impostazioni di sicurezza e dalle autorizzazioni per il database specifico. Se ad esempio non si dispone dell'autorizzazione per creare nuove stored procedure nel database, non è possibile completare l'opzione.

Nella pagina Visualizza risultati procedura guidata vengono visualizzati i risultati della creazione del TableAdapter. Se nel corso della procedura si verificano dei problemi, in questa pagina vengono visualizzate le informazioni sugli errori.

Usa stored procedure esistenti

In questa sezione viene illustrato come completare la Configurazione guidata TableAdapter quando è selezionata l'opzione Usa stored procedure esistenti.

Associa comandi alle stored procedure esistenti

Selezionare la stored procedure da eseguire per i comandi SELECT, INSERT, UPDATE e DELETE del TableAdapter. L'esecuzione di tali stored procedure avviene quando i metodi associati vengono chiamati sul TableAdapter. La stored procedure assegnata al comando Update, ad esempio, viene eseguita quando viene chiamato il metodo TableAdapter.Update().

Eseguire il mapping dei parametri dalla stored procedure selezionata alle colonne corrispondenti nella tabella dati. Se ad esempio la stored procedure accetta un parametro denominato @CompanyName che viene passato alla colonna CompanyName nella tabella, impostare la Colonna di origine del parametro @CompanyName su CompanyName.

Nota:
La stored procedure assegnata al comando SELECT viene eseguita chiamando il metodo del TableAdapter specificato nel passaggio successivo della procedura guidata. Poiché l'impostazione predefinita è Fill, il codice tipico per l'esecuzione della procedura SELECT è TableAdapter.Fill(tableName). Sostituire Fill con il nome assegnato se si desidera modificare l'impostazione predefinita di Fill, quindi sostituire "TableAdapter" con il nome effettivo del TableAdapter (ad esempio, CustomersTableAdapter).

La stored procedure assegnata al comando SELECT viene eseguita chiamando il metodo del TableAdapter specificato nel passaggio successivo della procedura guidata. Poiché l'impostazione predefinita è Fill, il codice tipico per l'esecuzione della procedura SELECT è TableAdapter.Fill(tableName). Sostituire Fill con il nome assegnato se si desidera modificare l'impostazione predefinita di Fill, quindi sostituire "TableAdapter" con il nome effettivo del TableAdapter (ad esempio, CustomersTableAdapter).

Opzioni avanzate

Fare clic su Opzioni avanzate per accedere alle opzioni avanzate del TableAdapter riportate di seguito. Per ulteriori informazioni, vedere Finestra di dialogo Opzioni avanzate generazione istruzioni SQL.

Genera istruzioni Insert, Update e Delete

Quando si seleziona questa opzione, nella procedura guidata si tenta di generare istruzioni INSERT, UPDATE e DELETE in base all'istruzione SELECT definita nella pagina Genera istruzioni SQL.
Usa concorrenza ottimistica

La selezione di questa opzione comporta la modifica delle istruzioni UPDATE e DELETE per rilevare se singoli record sono stati modificati rispetto alla lettura originaria nella tabella di dati. Se vengono rilevate violazioni di concorrenza, viene generata un'eccezione.
Aggiorna la tabella dati

Selezionando questa opzione si aggiornano i dati contenuti nella tabella dopo l'esecuzione delle istruzioni INSERT e UPDATE.

Operazioni successive

Al termine della procedura guidata, il TableAdapter viene aggiunto al dataset e può essere visualizzato e modificato in Progettazione DataSet. A questo punto è possibile eseguire una serie di operazioni:

Aggiungere altri TableAdapter. La procedura guidata consente di creare un TableAdapter. Per utilizzare un dataset contenente più tabelle, è opportuno aggiungere altri TableAdapter al dataset.
Aggiungere altre query al TableAdapter. Per ulteriori informazioni, vedere Procedura: creare query TableAdapter.
Visualizzare il dataset nella Finestra Origini dati e trascinare gli elementi nei form per creare controlli associati a dati. Per ulteriori informazioni, vedere Cenni preliminari sulla visualizzazione dei dati.

Vedere anche

Condividi tramite