Condividi tramite

Creare query TableAdapter con parametri nelle applicazioni .NET Framework

Annotazioni

La DataSet classe e le classi correlate sono tecnologie .NET Framework legacy dei primi anni '2000 che consentono alle applicazioni di lavorare con i dati in memoria mentre le app vengono disconnesse dal database. Le tecnologie sono particolarmente utili per le app che consentono agli utenti di modificare i dati e rendere persistenti le modifiche apportate al database. Sebbene i set di dati siano una tecnologia di successo comprovata, l'approccio consigliato per le nuove applicazioni .NET consiste nell'usare Entity Framework Core. Entity Framework offre un modo più naturale per usare i dati tabulari come modelli a oggetti e dispone di un'interfaccia di programmazione più semplice.

Una query con parametri restituisce dati che soddisfano le condizioni di una WHERE clausola all'interno della query. Ad esempio, è possibile parametrizzare un elenco di clienti per visualizzare solo i clienti in una determinata città aggiungendo WHERE City = @City alla fine dell'istruzione SQL che restituisce un elenco di clienti.

Le query con parametri di TableAdapter vengono create nel progettista di set di dati. È anche possibile crearle in un'applicazione Windows con il comando Parametrizza origine dati dal menu Dati. Il comando Parametrizza origine dati crea controlli nel modulo in cui è possibile immettere i valori dei parametri ed eseguire la query.

Annotazioni

Quando si crea una query con parametri, usare la notazione del parametro specifica per il database in cui si sta codificando. Ad esempio, le origini dati Access e OleDb usano il punto interrogativo '?' per indicare i parametri, quindi la WHERE clausola sarà simile alla seguente: WHERE City = ?.

Creare una query parametrizzata del TableAdapter

Per creare una query parametrizzata in Dataset Designer

  • Creare un nuovo TableAdapter, aggiungendo una WHERE clausola con i parametri desiderati all'istruzione SQL. Per altre informazioni, vedere Creare e configurare TableAdapters.

    o

  • Aggiungere una query a un TableAdapter esistente, aggiungendo una WHERE clausola con i parametri desiderati all'istruzione SQL.

Per creare una query con parametri durante la progettazione di un modulo collegato a dati

  1. Selezionare un controllo nel modulo già associato a un set di dati. Per altre informazioni, vedere Associare controlli Windows Form ai dati in Visual Studio.

  2. Scegliere Aggiungi query dal menu Dati.

  3. Completare la finestra di dialogo Generatore criteri di ricerca , aggiungendo una WHERE clausola con i parametri desiderati all'istruzione SQL.

Per aggiungere una query a un modulo associato a dati esistente

  1. Apri il form nel Windows Forms Designer.

  2. Nel menu Dati selezionare Aggiungi query o Smart Tag dati.

    Annotazioni

    Se Aggiungi query non è disponibile nel menu Dati , selezionare un controllo nel modulo in cui è visualizzata l'origine dati a cui si desidera aggiungere la parametrizzazione. Ad esempio, se il modulo visualizza i dati in un DataGridView controllo, selezionarlo. Se nel modulo vengono visualizzati dati in singoli controlli, selezionare qualsiasi controllo associato a dati.

  3. Nell'area Seleziona tabella origine dati selezionare la tabella a cui si desidera aggiungere la parametrizzazione.

  4. Digitare un nome nella casella Nuovo nome query se si sta creando una nuova query.

    o

    Selezionare una query nella casella Nome query esistente .

  5. Nella casella Testo query digitare una query che accetta parametri.

  6. Seleziona OK.

    Un controllo per immettere il parametro e un pulsante Carica vengono aggiunti al modulo tramite un controllo ToolStrip.

Eseguire una query per i valori Null

I parametri TableAdapter possono essere assegnati valori Null quando si desidera eseguire una query per i record senza valore corrente. Si consideri il seguente esempio di query con un ShippedDate parametro nella relativa WHERE clausola:

SELECT CustomerID, OrderDate, ShippedDate
FROM Orders
WHERE (ShippedDate = @ShippedDate) OR (ShippedDate IS NULL)

Se si tratta di una query su un TableAdapter, è possibile eseguire una query per tutti gli ordini che non sono stati spediti con il codice seguente:

ordersTableAdapter.FillByShippedDate(northwindDataSet.Orders, null);

Per abilitare una query per accettare valori Null:

  1. In Progettazione set di dati, selezionare la query TableAdapter che deve accettare valori di parametro null.

  2. Nella finestra Proprietà, selezionare Parametri e quindi selezionare il pulsante con i puntini di sospensione (...) per aprire l'Editor raccolta Parametri.

  3. Selezionare il parametro che consente valori Null e impostare la proprietà AllowDbNull su true.

Contenuti correlati

  • Last updated on