Procedura: creare query TableAdapter
Pubblicato: luglio 2016
Le query TableAdapter sono istruzioni SQL oppure stored procedure che possono essere eseguite dall'applicazione in uso su un database.
È possibile aggiungere a un TableAdapter tante query quante sono necessarie per l'applicazione. Le query TableAdapter vengono visualizzate su un TableAdapter come metodi. Quando viene creata una query denominata FillByCity che utilizza un parametro che rappresenta il valore relativo alla città, la query viene aggiunta all'oggetto TableAdapter come metodo tipizzato che accetta il tipo corretto di parametro come argomento, in questo caso una stringa che rappresenta il valore per la città. La query TableAdapter viene chiamata come qualsiasi metodo su qualunque oggetto. Ad esempio, il codice riportato di seguito consente di eseguire la query FillByCity e di riempire la tabella Customers con tutti i clienti che per città hanno il valore Seattle:
string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
Le query TableAdapter consentono di riempire una tabella di dati (query Fill e FillBy) oppure di restituire nuove tabelle di dati compilate con i dati restituiti dalla query (query GetData e GetDataBy).
È possibile aggiungere query ai TableAdapter mediante l'esecuzione della TableAdapter (query, configurazione guidata). Fare clic con il pulsante destro del mouse su un oggetto TableAdapter qualsiasi e scegliere Aggiungi query.
Nota
Nomi o percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzazione dell'IDE di Visual Studio.
Creazione di una query nella finestra Progettazione DataSet
Per aggiungere una query a un TableAdapter nella finestra Progettazione DataSet
Aprire un dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.
Fare clic con il pulsante destro del mouse sul TableAdapter desiderato e selezionare Aggiungi query.
In alternativa
Trascinare un oggetto Query dalla scheda DataSet della Casella degli strumenti su una tabella nella finestra di progettazione.
Viene aperta la Configurazione guidata query TableAdapter.
Completare la procedura guidata. La query verrà aggiunta al TableAdapter.
Creazione di una query direttamente in un form dell'applicazione Windows in uso
Se il form contiene un'istanza di un oggetto TableAdapter, è possibile aggiungere una query mediante la Finestra di dialogo Generatore di criteri per la ricerca, che consente di aggiungere al form un controllo ToolStrip che accetta qualsiasi parametro di input richiesto dalla query, oltre a un pulsante per eseguire la query.
Per aggiungere una query a un TableAdapter mediante la finestra di dialogo Generatore di criteri per la ricerca
Selezionare un oggetto TableAdapter nella barra dei componenti.
Fare clic sullo smart tag del TableAdapter, quindi scegliere Aggiungi query.
Compilare la finestra di dialogo e la query verrà aggiunta al TableAdapter. Per ulteriori informazioni, vedere Finestra di dialogo Generatore di criteri per la ricerca.
Vedere anche
Cenni preliminari sugli oggetti TableAdapter
Procedura: modificare query TableAdapter
Creazione e modifica di dataset tipizzati
Cenni preliminari sulle origini dati
Procedura: connettersi ai dati di un database
Convalida dei dati
Procedura: esplorare i dati con il controllo BindingNavigator Windows Form
Procedura dettagliata: visualizzazione di dati in un Windows Form
Procedura dettagliata: creazione di un oggetto TableAdapter con più query