TableAdapter (configurazione guidata)

Articolo
09/12/2015

La Configurazione guidata TableAdapter consente di creare e modificare oggetti TableAdapter. La procedura guidata crea oggetti TableAdapter in base alle istruzioni SQL inserite nella procedura stessa o in base a stored procedure esistenti nel database. Può anche creare nuove stored procedure nel database in base alle istruzioni SQL inserite nella procedura stessa.

Un oggetto TableAdapter consente di stabilire una connessione a un database, eseguire query o stored procedure su un database e popola un oggetto DataTable con i dati restituiti dalla query o stored procedure. Oltre a riempire le tabelle di dati esistenti con i dati, gli oggetti TableAdapter possono restituire nuove tabelle di dati popolate con i dati. Per altre informazioni, vedere Cenni preliminari sugli oggetti TableAdapter.

Esecuzione della procedura guidata

Eseguire la procedura guidata per creare o modificare oggetti TableAdapter e le tabelle dati associate. Per altre informazioni, vedere Procedura: avviare la Configurazione guidata TableAdapter.

Selezione della connessione dati

Scegliere una connessione esistente nell'elenco di connessioni disponibili oppure fare clic su Nuova connessione per creare una connessione al database.

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

Salvataggio della 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 per la connessione oppure usare il nome predefinito.

Salvando le stringhe di connessione nel file di configurazione dell'applicazione, è possibile semplificare il processo di gestione dell'applicazione se la connessione di database cambia. Se la connessione al database viene modificata, è possibile modificare la stringa di connessione nel file di configurazione dell'applicazione. In questo modo non sarà necessario modificare il codice sorgente e ricompilare l'applicazione. Per informazioni su come modificare una stringa di connessione nel file di configurazione dell'applicazione, vedere Procedura: salvare e modificare stringhe 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 altre informazioni, vedere Crittografia e decrittografia di dati.

Scegliere un tipo di comando

Scegliere il tipo di comando da eseguire sul database.

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

Usa istruzioni SQL consente di digitare un'istruzione SQL per selezionare i dati dal database.
Crea nuove stored procedure: selezionare questa opzione per consentire alla procedura guidata di creare nuove stored procedure (nel database) in base alle istruzioni SELECT specificate.
Usa stored procedure esistenti: selezionare questa opzione per mappare le stored procedure già esistenti nel database ai comandi SELECT, INSERT, UPDATE e DELETE dell'oggetto TableAdapter.

Usa istruzioni SQL

Questa sezione descrive come completare la Configurazione guidata TableAdapter quando è selezionata l'opzione Usa istruzioni SQL.

Nella pagina Genera le istruzioni SQL digitare l'istruzione SQL che, quando eseguita, riempirà la tabella dati con i dati.

Nella pagina Risultati procedura guidata vengono mostrati i risultati della creazione dell'oggetto TableAdapter. Se nel corso della procedura si verificano problemi, in questa pagina vengono visualizzate le informazioni sugli errori.

Scegliere i metodi per generare

In questa pagina sono disponibili le opzioni che permettono di selezionare i metodi TableAdapter generati dalla procedura guidata per il recupero e l'aggiornamento dei dati.

Riempi un DataTable
Crea il metodo predefinito dell'oggetto TableAdapter per riempire la tabella dati. Quando si chiama questo metodo, passare il nome della tabella dati come parametro.

È anche possibile modificare il nome predefinito nella casella Nome metodo.
Restituisci un DataTable
Crea il metodo dell'oggetto TableAdapter per la restituzione di una tabella dati popolata. In alcune applicazioni è preferibile restituire una tabella dati compilata invece di riempire con dati la tabella dati esistente.

È anche possibile modificare il nome predefinito nella casella Nome metodo.
Crea metodi per inviare aggiornamenti direttamente al database
Crea i comandi INSERT, UPDATE e DELETE necessari per scrivere le modifiche nel database sottostante. La selezione di questa casella equivale a impostare la proprietà GenerateDBDirectMethods su True.

Nota

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

Creare nuove stored procedure

Questa sezione descrive come completare la Configurazione guidata TableAdapter quando si seleziona l'opzione Crea nuove stored procedure.

Nella pagina Genera le stored procedure immettere l'istruzione SQL per il riempimento della tabella dati. Si tratta dell'istruzione SELECT dell'oggetto TableAdapter e della base per creare le stored procedure per selezionare, aggiornare, inserire ed eliminare i dati.
Nella pagina Crea le stored procedure eseguire le operazioni seguenti:
1. Digitare un nome per la nuova stored procedure.
2. Specificare se creare la stored procedure nel database sottostante.
  
  Nota
  
  La possibilità di creare una stored procedure nel database dipende dalle impostazioni di sicurezza e dalle autorizzazioni dello specifico database.Se ad esempio non si dispone delle autorizzazioni per creare nuove stored procedure nel database, questa opzione non può essere completata.
Nella pagina Risultati procedura guidata vengono mostrati i risultati della creazione dell'oggetto TableAdapter. Se nel corso della procedura si verificano problemi, in questa pagina vengono visualizzate le informazioni sugli errori.

Usa stored procedure esistenti

Questa sezione descrive come completare la Configurazione guidata TableAdapter quando si seleziona 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 dell'oggetto TableAdapter. Queste stored procedure vengono eseguite quando i metodi associati vengono chiamati sull'oggetto TableAdapter. Ad esempio, la stored procedure assegnata al comando Update viene eseguita quando viene chiamato il metodo TableAdapter.Update().

Mappare i 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 dell'oggetto TableAdapter a cui verrà assegnato il nome nel passaggio successivo della procedura guidata.Il valore predefinito è Fill, quindi il codice tipico per l'esecuzione della stored procedure SELECT è TableAdapter.Fill(tableName).Sostituire Fill con il nome assegnato, se il valore predefinito Fill è stato modificato, e sostituire "TableAdapter" con il nome effettivo dell'oggetto TableAdapter (ad esempio, CustomersTableAdapter).

Opzioni avanzate

Facendo clic su Opzioni avanzate è possibile accedere alle opzioni avanzate seguenti dell'oggetto TableAdapter.

Genera istruzioni INSERT, UPDATE e DELETE

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

Se si seleziona questa opzione, le istruzioni UPDATE e DELETE vengono modificate per rilevare se sono stati modificati singoli record in seguito alla lettura originale nella tabella dati. Se vengono rilevate violazioni della concorrenza, verrà generata un'eccezione.
Aggiorna DataTable

Se si seleziona questa opzione, dopo l'esecuzione delle istruzioni INSERT e UPDATE i dati nella tabella vengono aggiornati.

Passaggi successivi

Al termine della procedura guidata, l'oggetto TableAdapter viene aggiunto al set di dati ed è disponibile per la visualizzazione e la modifica in Progettazione DataSet. Successivamente, sarà possibile eseguire varie operazioni.

Aggiungere altri oggetti TableAdapter. La procedura guidata crea un solo oggetto TableAdapter. Se si intende usare un set di dati contenente più tabelle, sarà necessario aggiungere altri oggetti TableAdapter al set di dati.
Aggiungere altre query all'oggetto TableAdapter. Per altre informazioni, vedere Procedura: creare query TableAdapter.
Visualizzare il set di dati in Origini dati (finestra) e trascinare gli elementi sui form per creare controlli associati ai dati. Per altre informazioni, vedere Associazione di controlli Windows Form ai dati in Visual Studio.

Vedere anche

Condividi tramite