TableAdapter (query, configurazione guidata)

Articolo
08/11/2011

La Configurazione guidata query TableAdapter consente di creare e modificare le ulteriori query che è possibile aggiungere ai TableAdapter. Una query TableAdapter è una qualsiasi query SQL o stored procedure valida che restituisce dati conformi allo schema della tabella di dati associata del TableAdapter o che restituisce un valore scalare. Al termine della procedura guidata, verrà aggiunto un metodo al TableAdapter che, in seguito alla chiamata, consentirà di eseguire la query, ad esempio CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").

Esecuzione della procedura guidata

Trascinare le query in Progettazione DataSet oppure configurare quelle esistenti, ovvero quelle elencate al di sotto della prima query.

La prima query in un TableAdapter è la query TableAdapter principale. Se tale query viene modificata, viene aperta la Configurazione guidata TableAdapter e viene modificato lo schema della tabella dati del TableAdapter. Tutte le query elencate al di sotto di quella principale sono query aggiuntive e vengono configurate utilizzando la Configurazione guidata query TableAdapter. Per ulteriori informazioni sull'esecuzione della procedura guidata, vedere Procedura: avviare la Configurazione guidata query 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 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.

Usa istruzioni SQL

In questa sezione viene illustrato come completare la Configurazione guidata query TableAdapter quando si seleziona l'opzione Usa istruzioni SQL.

Scegli tipo di query

La procedura guidata consente di creare diversi tipi di query in base ai requisiti dell'applicazione. È possibile scegliere query SELECT che restituiscono righe di dati (una tabella di dati) o query SELECT che restituiscono un valore scalare (un singolo valore come Count o Sum).

Nella pagina Scegli tipo di query selezionare il tipo di query da creare dall'elenco di query disponibili.

Nota

La creazione di un'istruzione INSERT, UPDATE o DELETE non comporta la sostituzione dei comandi del TableAdapter utilizzati quando si chiama il relativo metodo Update. Se ad esempio si seleziona UPDATE come tipo di query, verrà creata una nuova query con un nome specificato successivamente nella procedura guidata. Per eseguire la query è necessario chiamare questo metodo del TableAdapter. In seguito alla chiamata del metodo Update del TableAdapter verranno eseguite le istruzioni create al momento della configurazione del TableAdapter originale.

Specifica un'istruzione SQL <tipo di query>

Nella pagina Specifica un'istruzione SQL digitare l'istruzione SQL da eseguire per la chiamata della query.

Suggerimento
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.

Scegliere i metodi per generare

In questa pagina sono contenute le opzioni per la selezione dei metodi da generare per la query mediante la procedura guidata.

Riempi una DataTable
Consente di creare un metodo per il riempimento della tabella dati. Quando si chiama questo metodo per riempire la tabella dati con i dati restituiti, il nome di tale tabella viene passato come parametro.

È anche possibile modificare il nome predefinito nella casella Nome metodo. La specifica di un nome significativo può risultare utile quando la query viene utilizzata in una stringa di codice.
Restituisci una DataTable
Consente di creare un metodo per la restituzione di una tabella 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.

Scegli il nome della funzione

Digitare un nome per la funzione. La creazione di una query TableAdapter comporta l'aggiunta al TableAdapter di un metodo con il nome specificato. Chiamare tale metodo per eseguire la query. La specifica di un nome significativo è utile quando la query viene utilizzata in una stringa di codice.

Nota

Durante la creazione di nuove stored procedure, viene richiesta l'immissione di due nomi. Il primo è il nome della stored procedure creata nel database, il secondo è il nome del metodo del TableAdapter che consente di eseguire la stored procedure quando viene chiamato.

Crea nuove stored procedure

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

Nella pagina Genera le stored procedure digitare l'istruzione SQL da eseguire quando viene chiamata la stored procedure.

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.
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 una stored procedure nel database dipende dalle impostazioni di sicurezza del database specifico.
Nella pagina Visualizza risultati procedura guidata sono riportati i risultati della creazione della query 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 query TableAdapter quando si seleziona l'opzione Usa stored procedure esistenti.

Selezionare una stored procedure esistente dall'elenco a discesa nella pagina Selezionare una stored procedure esistente della procedura guidata.

I Parametri e i Risultati relativi alla stored procedure selezionata vengono visualizzati per riferimento.
Scegliere Avanti.

Scegliere la forma dei dati restituiti dalla stored procedure

Il tipo di dati restituiti dalla stored procedure selezionata determina la modalità di creazione dei metodi del TableAdapter mediante la procedura guidata.

Selezionare il tipo di dati restituiti da questa query.

Se si seleziona Dati tabulari verrà aperta la pagina Scegliere i metodi da generare, descritta in una sezione precedente di questa pagina della Guida, nella quale è possibile specificare i tipi di metodi, i nomi di metodo e il supporto per lo spostamento.
Selezionando Un valore verrà creato un metodo tipizzato che restituisce un singolo valore. Verrà inoltre aperta la pagina Scegli il nome della funzione, descritta in precedenza in questa pagina della Guida.
Se si seleziona Nessun valore verrà creato un metodo tipizzato per l'esecuzione della stored procedure senza restituzione di dati. Verrà inoltre aperta la pagina Scegli il nome della funzione, descritta in precedenza in questa pagina della Guida.

Visualizza risultati procedura guidata

Nella pagina Visualizza risultati procedura guidata sono riportati i risultati della creazione della query TableAdapter. Se nel corso della procedura si verificano dei problemi, in questa pagina vengono visualizzate le relative informazioni.

Vedere anche

Share via