Vyplnění datových sad pomocí objektů TableAdapter v aplikacích .NET Framework

Komponenta TableAdapter vyplní datovou sadu daty z databáze na základě jednoho nebo více dotazů nebo uložených procedur, které zadáte. Objekty TableAdapter mohou také provádět přidání, aktualizace a odstranění databáze, aby se zachovaly změny provedené v datové sadě. Můžete také vydat globální příkazy, které nesouvisejí s žádnou konkrétní tabulkou.

Podrobné informace o operacích TableAdapter můžete přeskočit přímo na jedno z těchto témat:

Přehled objektů TableAdapter

Objekty TableAdapter jsou komponenty generované návrhářem, které se připojují k databázi, spouštějí dotazy nebo uložené procedury a vyplní dataTable vrácenými daty. Objekty TableAdapter také odesílají aktualizovaná data z vaší aplikace zpět do databáze. Na objektu TableAdapter můžete spouštět tolik dotazů, kolik chcete, pokud vrací data, která odpovídají schématu tabulky, ke které je přidružen objekt TableAdapter. Následující diagram ukazuje, jak Objekty TableAdapter pracují s databázemi a dalšími objekty v paměti:

Zatímco TableAdapter jsou navrženy pomocí Návrhář datové sady, Třídy TableAdapter nejsou generovány jako vnořené třídy DataSet. Nacházejí se v samostatných oborech názvů, které jsou specifické pro každou datovou sadu. Pokud máte například datovou sadu s názvem NorthwindDataSet, objekty TableAdapter, které jsou přidruženy k DataTableobjektům v NorthwindDataSet oboru názvů, budou v NorthwindDataSetTableAdapters oboru názvů. Pro programový přístup k určitému typu TableAdapter musíte deklarovat novou instanci typu TableAdapter. Příklad:

NorthwindDataSet northwindDataSet = new NorthwindDataSet();

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter = 
    new NorthwindDataSetTableAdapters.CustomersTableAdapter();

customersTableAdapter.Fill(northwindDataSet.Customers);

Dim northwindDataSet As New NorthwindDataSet()
Dim customersTableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()

customersTableAdapter.Fill(northwindDataSet.Customers)

Přidružené schéma datové tabulky

Při vytváření objektu TableAdapter použijete počáteční dotaz nebo uloženou proceduru k definování schématu přidruženého DataTableobjektu TableAdapter . Tento počáteční dotaz nebo uloženou proceduru spustíte voláním metody TableAdapter Fill (která vyplní přidružené DataTableTableAdapter ). Všechny změny provedené v hlavním dotazu TableAdapter se projeví ve schématu přidružené tabulky dat. Například odebrání sloupce z hlavního dotazu odebere také sloupec z přidružené tabulky dat. Pokud některé další dotazy v objektu TableAdapter používají příkazy SQL, které vracejí sloupce, které nejsou v hlavním dotazu, návrhář se pokusí synchronizovat změny sloupce mezi hlavním dotazem a dalšími dotazy.

Příkazy update TableAdapter

Funkce aktualizace objektu TableAdapter závisí na tom, kolik informací je k dispozici v hlavním dotazu v Průvodci objektem TableAdapter. Například objekty TableAdapter, které jsou nakonfigurované tak, aby načítály hodnoty z více tabulek (pomocí JOIN), skalárních hodnot, zobrazení nebo výsledků agregačních funkcí, nejsou původně vytvořeny s možností odesílat aktualizace zpět do podkladové databáze. Příkazy INSERTa příkazy UPDATEDELETE však můžete nakonfigurovat ručně v okně Vlastnosti.

TableAdapter – dotazy

Objekty TableAdapter mohou obsahovat více dotazů k vyplnění přidružených datových tabulek. Objektu TableAdapter lze definovat tolik dotazů, kolik vyžaduje vaše aplikace, pokud každý dotaz vrací data, která odpovídají stejnému schématu jako jeho přidružená tabulka dat. Tato funkce umožňuje, aby TableAdapter načetl různé výsledky na základě různých kritérií.

Pokud například vaše aplikace obsahuje tabulku se jmény zákazníků, můžete vytvořit dotaz, který vyplní tabulku všemi jmény zákazníků, které začínají určitým písmenem, a další, která vyplní tabulku všemi zákazníky umístěnými ve stejném stavu. Customers Pokud chcete vyplnit tabulku se zákazníky v daném stavu, můžete vytvořit FillByState dotaz, který vezme parametr pro hodnotu stavu následujícím způsobem: SELECT * FROM Customers WHERE State = @State. Dotaz spustíte voláním FillByState metody a předáním hodnoty parametru takto: CustomerTableAdapter.FillByState("WA").

Kromě přidávání dotazů, které vracejí data stejného schématu jako tabulka dat TableAdapter, můžete přidat dotazy, které vracejí skalární (jednoduché) hodnoty. Například dotaz, který vrací počet zákazníků (SELECT Count(*) From Customers) je platný, CustomersTableAdapter, i když vrácená data neodpovídají schématu tabulky.

ClearBeforeFill – vlastnost

Ve výchozím nastavení se při každém spuštění dotazu, který vyplní tabulku dat TableAdapter, vymažou se stávající data a do tabulky se načtou jenom výsledky dotazu. Vlastnost TableAdapter ClearBeforeFill nastavte false , pokud chcete přidat nebo sloučit data vrácená z dotazu na existující data v tabulce dat. Bez ohledu na to, jestli vymažete data, musíte explicitně odesílat aktualizace zpět do databáze, pokud je chcete zachovat. Nezapomeňte proto před spuštěním dalšího dotazu, který vyplní tabulku, uložit všechny změny dat v tabulce. Další informace naleznete v tématu Aktualizace dat pomocí TableAdapter.

Dědičnost objektů TableAdapter

Objekty TableAdapter rozšiřují funkčnost standardních datových adaptérů zapouzdřením nakonfigurované DataAdapter třídy. Objekt TableAdapter ve výchozím nastavení dědí z Component třídy a nemůže být přetypován do DataAdapter třídy. Přetypování objektu TableAdapter do DataAdapter třídy způsobí InvalidCastException chybu. Chcete-li změnit základní třídu objektu TableAdapter, můžete určit třídu, která je odvozena z Component vlastnosti Základní třída Objekt TableAdapter v Návrháři datových sad.

Metody a vlastnosti TableAdapter

Třída TableAdapter není typem .NET. To znamená, že ho nemůžete vyhledat v dokumentaci ani v prohlížeči objektů. Když použijete některého z dříve uvedených průvodců, vytvoří se v době návrhu. Název přiřazený k prvku TableAdapter při jeho vytvoření je založený na názvu tabulky, se kterou pracujete. Například při vytvoření TableAdapter založené na tabulce v databázi s názvem Orders, TableAdapter je pojmenován OrdersTableAdapter. Název třídy TableAdapter lze změnit pomocí Vlastnosti Name v Návrháři datové sady.

Tady jsou běžně používané metody a vlastnosti TableAdapter:

Metoda update TableAdapter

Objekty TableAdapter používají příkazy pro čtení a zápis dat z databáze. Jako základ pro vytvoření schématu přidružené tabulky dat a DeleteCommand InsertCommandUpdateCommandpříkazů přidružených k TableAdapter.Update metodě použijte počáteční Fill (hlavní) dotaz TableAdapter. Volání metody TableAdapter Update spustí příkazy vytvořené při původní konfiguraci TableAdapter, nikoli jeden z dalších dotazů, které jste přidali pomocí Průvodce konfigurací dotazu TableAdapter.

Když použijete TableAdapter, efektivně provádí stejné operace s příkazy, které byste obvykle provedli. Když například zavoláte metodu adaptéru Fill , spustí adaptér ve své SelectCommand vlastnosti datový příkaz a pomocí čtečky dat (například SqlDataReader) načte sadu výsledků do tabulky dat. Podobně když zavoláte metodu adaptéru Update , spustí příslušný příkaz (v objektu UpdateCommand, InsertCommanda DeleteCommand vlastnosti) pro každý změněný záznam v tabulce dat.

Vlastnost GenerateDBDirectMethods třídy TableAdapter

Kromě InsertCommandobjektů TableAdapter , UpdateCommanda DeleteCommand, jsou vytvořeny pomocí metod, které lze spustit přímo proti databázi. Tyto metody (TableAdapter.Insert, TableAdapter.Updatea TableAdapter.Delete) můžete volat přímo pro manipulaci s daty v databázi. To znamená, že tyto jednotlivé metody můžete z kódu volat místo volání TableAdapter.Update pro zpracování vložení, aktualizací a odstranění čekajících na tabulku přidružených dat.

Pokud tyto přímé metody nechcete vytvořit, nastavte vlastnost GenerateDbDirectMethods objektu TableAdapter (falsev okně Properties). Další dotazy přidané do objektu TableAdapter jsou samostatné dotazy – negenerují tyto metody.

Podpora tableAdapter pro typy s možnou hodnotou null

TableAdapter podporují typy Nullable(Of T) s možnou hodnotou null a T?. Další informace otypech Další informace o typech s možnou hodnotou null v jazyce C# naleznete v tématu Použití typů s možnou hodnotou null.

Referenční dokumentace tableAdapterManager

Ve výchozím nastavení třída TableAdapterManager generuje při vytváření datové sady, která obsahuje související tabulky. Chcete-li zabránit generování třídy, změňte hodnotu Hierarchical Update vlastnosti datové sady na false. Když přetáhnete tabulku, která má relaci na návrhovou plochu stránky Windows Form nebo WPF, Visual Studio deklaruje členovou proměnnou třídy. Pokud nepoužíváte vazbu dat, musíte proměnnou deklarovat ručně.

Třída TableAdapterManager není typem .NET. Proto ho nemůžete vyhledat v dokumentaci. Vytvoří se v době návrhu jako součást procesu vytváření datové sady.

Níže jsou uvedené často používané metody a vlastnosti TableAdapterManager třídy:

Zabezpečení

Pokud používáte datové příkazy s vlastností CommandType nastavenou na Text, pečlivě zkontrolujte informace odesílané z klienta před předáním do databáze. Uživatelé se zlými úmysly se mohou pokusit odeslat (vložit) upravené nebo další příkazy SQL ve snaze získat neoprávněný přístup nebo poškodit databázi. Před přenosem uživatelského vstupu do databáze vždy ověřte, zda jsou informace platné. Osvědčeným postupem je vždy používat parametrizované dotazy nebo uložené procedury, pokud je to možné.

Související obsah

• Nástroje datové sady