Vytváření parametrizovaných dotazů TableAdapter
Publikováno: srpen 2016
Parametrizovaný dotaz vrací data, která splňuje podmínky klauzule WHERE v dotazu. Například můžete parametrizovat seznam zákazníků, chcete-li zobrazit pouze zákazníci v určitém městě přidáním WHERE City = @City na konec příkazu SQL, který vrací seznam zákazníků.
Vytváření parametrizovaných dotazů TableAdapter v Návrháře Dataset, nebo během vytváření formuláře vázané na data v aplikaci systému Windows Parametrizace zdroj dat příkaz na Data nabídky.Parametrizace zdroj dat příkaz také vytvoří ovládací prvky na formuláři pro vstupní hodnoty parametrů a provedení dotazu.
Poznámka
Při sestavování parametrizovaného dotazu, použijte parametr notace specifické pro databázi, kterou je implementován proti. Například přístup a OleDb zdroje dat použít otazník "?" k označení parametry, takže klauzule WHERE bude vypadat takto: WHERE City = ?.
Poznámka
Dialogová okna a příkazy nabídek, které se může lišit od těch popsaných v nápovědě v závislosti na aktivních nastaveních nebo edici. Chcete-li změnit nastavení, zvolte Nastavení importu a exportu na Nástroje nabídky. Další informace naleznete v tématu Přizpůsobení nastavení pro vývoj v sadě Visual Studio.
Vytvoření parametrického dotazu TableAdapter
Vytvoření parametrického dotazu v Návrháři Dataset
Vytvořte nové třídy TableAdapter, přidání klauzule WHERE se požadované parametry příkazu SQL. Další informace naleznete v tématu Vytvořit a konfigurovat objekty TableAdapter.
- nebo -
Přidáte dotaz do existující třídy TableAdapter přidání klauzule WHERE se požadované parametry příkazu SQL. Další informace naleznete v tématu Postupy: Vytváření dotazů TableAdapter.
Vytvoření parametrického dotazu při návrhu formuláře vázané na data
Vyberte ovládací prvek na formuláři, který je již vázán na datovou sadu. Další informace naleznete v tématu Vytvoření vazby ovládacích prvků Windows Forms k datům v sadě Visual Studio.
Na Data nabídky, klikněte na tlačítko Přidat dotaz.
Dokončení Tvůrce kritérií vyhledávání dialogové okno, přidání klauzule WHERE se požadované parametry příkazu SQL.
Chcete-li přidat dotaz do existujícího formuláře vázané na data
Otevřete formulář v Návrhář formulářů Windows.
Klikněte na tlačítko Přidat dotaz na Data nabídky nebo dat inteligentní značky.
Poznámka
Pokud Přidat dotaz není k dispozici na Data nabídka, vyberte ovládací prvek na formuláři, zobrazí zdroj dat, můžete přidat Parametrizace do. Například, pokud data ve formuláři se zobrazí DataGridView řízení, vyberte ji. Pokud formulář zobrazí data v jednotlivých ovládacích prvků, vyberte všechny ovládací prvky vázané na data.
Vyberte požadovanou tabulku, kterou chcete přidat Parametrizace v zdrojové tabulce vyberte data oblasti.
Zadejte název do Nový název dotazu pole, pokud vytváříte nový dotaz.
- nebo -
Vyberte dotaz v název dotazu existující pole.
Zadejte dotaz, který přebírá parametry Text dotazu pole.
Klikněte na tlačítko OK.
Ovládací prvek pro vstupní parametr a zatížení tlačítko jsou přidány do formuláře ve ToolStrip ovládacího prvku.
Parametry TableAdapter lze přiřadit hodnoty null, pokud chcete zadat dotaz pro záznamy, které nemají žádnou aktuální hodnotu. Zvažte například následující dotaz, který má ShippedDate parametr v jeho WHERE klauzule:
SELECT CustomerID, OrderDate, ShippedDate
FROM Orders
WHERE (ShippedDate = @ShippedDate) OR
(ShippedDate IS NULL)
Pokud by to byla dotazů v TableAdapter, může dotaz pro všechny příkazy, které nebyly dodány s následujícím kódem:
ordersTableAdapter.FillByShippedDate(northwindDataSet.Orders, null);
OrdersTableAdapter.FillByShippedDate(NorthwindDataSet.Orders, Nothing)
Chcete-li povolit dotaz tak, aby přijímal hodnoty null
V Návrháře Dataset, vyberte dotazu TableAdapter, který je potřeba přijmout hodnoty parametr null.
Vyberte Parametry v Vlastnosti okna a klikněte na tlačítko se třemi tečkami (...) tlačítko otevřete Editor kolekce parametrů.
Vyberte parametr, který povoluje hodnoty null a nastavte AllowDbNull vlastnost
true.