TableAdapter (configurazione guidata)

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. Inoltre, consente di creare nuove stored procedure nel database in base alle 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: salvare e modificare stringhe di connessione.

Nota sulla sicurezzaNota 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 a uno strumento visivo per la creazione di query SQL denominato Generatore di query. 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.

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.

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 una 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 una DataTable
    Consente di creare il metodo di TableAdapter per la restituzione di una tabella di dati compilata. In alcune applicazioni è preferibile restituire una tabella dati compilata piuttosto che 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
    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.

  1. 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 a uno strumento visivo per la creazione di query SQL denominato Generatore di query. 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.

  2. Nella pagina Crea le stored procedure effettuare le seguenti operazioni:

    1. Digitare un nome per la nuova stored procedure.

    2. 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).

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.

Passaggi successivi

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:

Vedere anche

Attività

Procedura: creare query TableAdapter

Procedura: modificare query TableAdapter

Procedura: connettersi ai dati di un database

Procedura dettagliata: visualizzazione di dati in un Windows Form

Riferimenti

TableAdapter (query, configurazione guidata)

Concetti

Novità dello sviluppo di applicazioni di dati

Associazione di controlli Windows Form ai dati in Visual Studio

Progettazione DataSet

Cenni preliminari sulle origini dati

Associazione di controlli ai dati in Visual Studio

Altre risorse

Procedure dettagliate relative ai dati

Convalida dei dati