Condividi tramite


Procedura: creare query TableAdapter

Aggiornamento: novembre 2007

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:

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
string cityValue = "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 Configurazione guidata query TableAdapter. Fare clic con il pulsante destro del mouse su un oggetto TableAdapter qualsiasi e scegliere Aggiungi query.

Nota:

È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida in linea a seconda delle impostazioni attive o dell'edizione del programma. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Creazione di una query nella finestra Progettazione DataSet

Per aggiungere una query a un TableAdapter nella finestra Progettazione DataSet

  1. Aprire un dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.

  2. Fare clic con il pulsante destro del mouse sul TableAdapter desiderato e selezionare Aggiungi query.

    - oppure -

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

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

  1. Selezionare un oggetto TableAdapter nella barra dei componenti.

  2. Fare clic sullo smart tag del TableAdapter, quindi scegliere Aggiungi query.

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

Attività

Procedura: modificare query TableAdapter

Procedura: connettersi ai dati di un database

Procedura: esplorare i dati con il controllo BindingNavigator Windows Form

Procedura dettagliata: visualizzazione dei dati su un form in un'applicazione Windows

Concetti

Cenni preliminari sugli oggetti TableAdapter

Cenni preliminari sulla visualizzazione dei dati

Progettazione DataSet

Cenni preliminari sulle origini dati

Altre risorse

Convalida dei dati