ADO.NET - Úvod do databází v prostředí.net. Jan Kupka

Transkript

1 ADO.NET - Úvod do databází v prostředí.net Jan Kupka 2. května 2005

2

3 Obsah 1 Úvod do ADO.NET Co je to ADO.NET? Pro koho je tato příručka určena? Co budete potřebovat? Databáze SQL Server MSDE Oracle MySQL Microsoft Access Ostatní databázové systémy Technologie ADO.NET Připojení k databázi Využití vlastností platformy.net XML Zprostředkovatelé přístupu k databázovým systémům Architektura ADO.NET Jmenné prostory Přehled tříd Třídy pro správu dat DataSet DataTable Události DataTable DataColumn Vlastnosti sloupců DataRow Constraints DataRelation DataColumnMapping a DataTableMapping Třídy pro připojení k databázi Připojení k databázi (SqlConnection) Provádění SQL dotazů (SqlCommand) Datový adaptér (SqlDataAdapter) Aktualizace dat v databázi Tvorba příkazů (SqlCommandBuilder) Snímač dat (SqlDataReader)

4 ADO.NET Obsah 5.6 Transakce (SqlTransaction) XML 19 7 Visual Studio.NET Připojení k databázi (SqlConnection) Provádění SQL dotazů (SqlCommand) Datový adaptér (SqlDataAdapter) DataSet DataView DataGrid Závěr 23 A Úvod do MSDE 24 A.1 Instalace MSDE A.2 Práce s MSDE A.3 Příprava základní databáze aneb rychlokurz SQL A.4 Správa MSDE

5 Kapitola 1 Úvod do ADO.NET Vítám Vás při čtení příručky ADO.NET - Úvod do databází v prostředí.net. Tato příručka si klade za cíl vás seznámit s přístupem k databázím v prostředí.net firmy Microsoft. Databáze hrají v dnešním počítačovém světě stále důležitější roli v profesionálním i amatérském využití. Stejně tak si své místo pod Sluncem snaží dobýt prostředí.net. Díky podpoře Microsoftu a nasazení v budoucích operačních systémech je jeho úspěch jistý. A pokud spojíte.net s databázemi, dostanete ADO.NET, o kterém pojednává tato příručka. V této příručce se nachází mnoho ukázkových příkladů jednotlivých komponent ADO.NET. Kompletní ukázkové příklady by však zabraly mnoho místa a proto jsou v této příručce pouze podstatné části programů. Pokud by jste měli zájem o kompletní příklady, tak je naleznete na stránce Problematika databází v prostředí ADO.NET je natolik rozsáhlá, že by kompletní publikace o ADO.NET zabrala tisíce stránek. Tato příručka by vám pouze měla zjednodušit start a nasměrovat vás pro další samostatné bádání. Díky neuvěřitelnému tempu, jakým byla publikace napsána, se v ní téměř jistě vyskytnou chyby a nepřesnosti. Budu tedy velmi rád, když mi jakékoliv vaše připomínky, výhrady a postřehy pošlete na mojí mailovou adresu: kupka@students.zcu.cz. 1.1 Co je to ADO.NET? Ze všeho nejdříve bychom si měli říci, co je vlastně ADO.NET, o kterém je celá tato příručka napsána. ADO.NET je rozsáhlou knihovnou tříd, které nám umožňují pracovat s databázemi a datovými soubory. Jelikož se jedná o součást.net frameworku, poskytuje ADO.NET uživateli veškeré vymoženosti, které obsahuje samotný.net. Jde zejména o podporu mnoha jazyků (C#, Managed C++, Visual Basic.NET, J# a dalších), automatické uvolňování paměti a objektově orientovaný přístup. 1.2 Pro koho je tato příručka určena? Tato příručka je určena všem programátorům, kteří mají zkušenosti s programováním v jazyce C#. Samozřejmostí je znalost platformy.net. Dále je doporučena znalost přístupu k databázovým systémům na programátorské úrovni v libovolném programovacím jazyce. 1.3 Co budete potřebovat? Pro práci s ADO.NET budete samozřejmě potřebovat.net Framework SDK. Své programy můžete psát v libovolném textovém editoru a posléze interpretovat 3

6 ADO.NET Kapitola 1 pomocí řádkového interpretu, který je přiložen k.net Framework SDK. Pro komfortnější práci ovšem doporučuji Microsoft Visual Studio.NET. Dále budete potřebovat databázový systém. Můžete používat jakýkoliv databázový systém podle vašeho osobního vkusu a podle toho, kolik peněz do systému můžete investovat. Pokud žádný databázový systém nepoužíváte, podívejte se do přílohy A a tam naleznete popis instalace a spuštění databázového systému MSDE. V příloze A rovněž naleznete postup vytvoření jednoduché databáze pro systém MSDE, která je v knize použita k předvádění práce s třídami ADO.NET. 1.4 Databáze Pomocí rozhraní ADO.NET můžete připojit k programu libovolný databázový systém. Požadavkem je pouze to, aby systém měl vlastní OleDb ovladač. Tento ovladač naleznete prakticky u všech databázových systémů. V následujících odstavcích si přiblížíme nejpoužívanější databázové systémy SQL Server SQL Server je databázový systém firmy Microsoft, což mu v ADO.NET dává určitý náskok před ostatními. Je pro něj připraveno vylepšené rozhraní, které mu umožňuje v některých případech dosahovat lepších výsledků než u ostatních systémů. Jeho nevýhodou je však vysoká cena. V současné době je nejnovější verzí Microsoft SQL Server Produkt je k dispozici ve třech základních verzích : Enterprise, Standard, Workgroup. Dalšími verzemi Microsoft SQL Serveru jsou například verze pro vývojáře nebo pro operační systém Windows CE. Firma Microsoft v současnosti dokončuje novou verzi SQL serveru - Microsoft SQL Server Internetové stránky programu: MSDE MSDE není vlastně samostatný produkt. Je to jedna z verzí programu Microsoft SQL Serveru. Nespornou výhodou této verze je to, že je k dispozici zdarma. Je výhodná pro domácí použití, stejně jako pro vývojáře aplikací. MSDE je distribuována bez administrátorských nástrojů. Na internetu se dá ovšem sehnat mnoho vynikajících administrátorských nástrojů pro tento databázový systém, např. MSDE Manager nebo DBA Manager Dalším omezením je maximální počet pěti současně spuštěných procesů. Každý další proces musí počkat na skončení některého běžícího. Připojení k MSDE z programu je stejné jako u SQL Serveru, takže v případě, že už vám možnosti MSDE přestanou stačit, můžete bez problémů přejít na placený SQL Server. Společně s komerční verzí produktu Microsoft SQL Server 2005 by měla vyjít i nekomerční verze - Microsoft SQL Server 2005 Express, která bude nástupcem MSDE. Podle vyjádření pracovníků firmy Microsoft by měla být tato omezená verze pro vývojáře a domácí uživatele dostupná zdarma či za cenu distribučních nákladů. Internetové stránky programu: /msde/ Oracle Oracle je přímým konkurentem SQL Serveru na poli databázových systémů. Firma Oracle v současné době nabízí svůj produkt Oracle ve verzi 10. Jedná se, stejně jako u SQL Serveru, o placený produkt. Existuje ovšem i jeho nekomerční verze, kterou je možné si po zaregistrování stáhnout z webových stránek firmy. Internetové stránky programu: 4

7 ADO.NET Kapitola MySQL MySQL je nejpopulárnější open-source databázový systém. Velkou výhodou je hlavně jeho multiplatformní použití, může být nasazen na operačních systémech Unix, Linux, Solaris, OS/2 i Windows. Protože je tento systém zdarma, nepodporuje některé funkce, které komerční systémy poskytují. Internetové stránky programu: Microsoft Access Program, který je součástí balíku Microsoft Office firmy Microsoft a dá se použít pro tvorbu jednoduchých jednouživatelských databází. Pro jednoduchý systém či seznámení s databázemi tento program postačuje, ale osobně bych doporučil přeci jen raději některý z výše uvedených programů. Internetové stránky programu: Ostatní databázové systémy Prostřednictvím rozhraní ADO.NET můžete připojit k programu i další databázové servery. Výše uvedené programy však na poli databázových serverů představují absolutní špičku, a proto nebudou jiné databázové systémy v této příručce zmíněny. 5

8 Kapitola 2 Technologie ADO.NET V této kapitole se podíváme na ADO.NET trochu podrobněji. Zjistíme, jak ADO.NET pracuje, a co nového přináší v přístupu k databázím. 2.1 Připojení k databázi Doba, kdy byly databáze uloženy na stejném počítači, ze kterého byly programem načítány, je stejně jako ukládání databází do jednoho souboru definitivně pryč. V dnešním světě potřebuje uživatel přistupovat k databázi z libovolného místa v internetu. Tento požadavek se samozřejmě musel promítnout do přístupu k databázím. V minulosti, kdy byla databáze umístěna na stejném počítači jako aplikace přistupující k ní, mohl být udržován přístup k databází po celou dobu běhu programu a nikomu to nevadilo. V dnešní době už tento postup není vhodný, neboť k databázi mohou přistupovat naráz tisíce uživatelů, což by okamžitě vedlo k omezení funkčnosti systému. Dalším důvodem je nespolehlivost síťového spojení, které může často padat, což by mělo za následek neustálé znovupřipojování k databázi. Z těchto důvodů vývojáři ve firmě Microsoft napsali ADO.NET tak, aby spojení s databází bylo navázáno pouze po dobu zpracování dotazu. Tento přístup s sebou ovšem také přináší některé problémy. Jedním z nich je například udržení konzistence dat v paměti a v databázovém systému. 2.2 Využití vlastností platformy.net ADO.NET je součástí.net framework, což přináší mnoho výhod. Uveďme například objektově orientované programování, automatickou správu paměti či rozsáhlý systém vyjímek. Z tohoto plyne také použití libovolného jazyka obsahujícího podporu platformy.net. 2.3 XML Jazyk XML (extensible Markup Language) je často označován jako revoluční technologie. Je to hlavně díky jeho otevřenosti a jazykové nezávislosti. XML má podporu už v.net Framework, ale ADO.NET jde ještě dál. Jazyk XML se stal stěžejním jazykem pro přenos dat v prostředí ADO.NET. 6

9 ADO.NET Kapitola Zprostředkovatelé přístupu k databázovým systémům Jak už jsem napsal výše, tak ADO.NET umožňuje připojení k libovolnému databázovému systému, pro nějž existují OleDb ovladače. Nebyl by to ale Microsoft, kdyby pro svůj produkt nevytvořil něco extra. Pokud tedy používáte databázový systém Microsoft SQL Server (případně MSDE), můžete používat speciální datové typy, které byly vytvořeny speciálně pro tento databázový systém. Pro přístup k databázovému systému Microsoft SQL Server (případně free verzi MSDE) je vytvořen zprostředkovatel SqlClient (jmenný prostor System.Data.SqlClient) a pro přístup k ostatním databázím (Oracle, MySQL, atd.) je zde zprostředkovatel OleDb (jmenný prostor System.Data.OleDb). Zprostředkovatel SqlClient je kompletně napsaný v řízeném kódu a při připojení k databázi se snaží využívat co nejmenší počet vrstev, což by mu ve většině případů mělo pomoci k dosažení větší rychlosti přístupu než je tomu u zprostředkovatele OleDb. 7

10 Kapitola 3 Architektura ADO.NET 3.1 Jmenné prostory Jmenné prostory, které musíte do svých programů zahrnout (pomocí syntaxe using), aby váš program mohl pracovat s databázemi: System.Data - jmenný prostor pro všechny obecné třídy a rozhraní pro přístup k datům v ADO.NET System.Data.Common - třídy sdílené zprostředkovateli dat System.Data.OleDb - třídy zprostředkovatele OleDb System.Data.SqlClient -třídy zprostředkovatele SQL Server System.Data.SqlTypes - datové typy aplikace SQL Server 3.2 Přehled tříd Třídy v knihovně ADO.NET lze rozdělit na dvě množiny. První množinu tvoří třídy zaměřené na správu dat (Data Related Components). Tyto třídy jsou zcela nezávislé na databázi a reprezentují umístění dat z databáze v paměti. Druhou množinu tvoří třídy závislé na použité databázi (Data Provider Components). Tyto třídy umožňují propojení mezi třídami pro správu dat a databázovými systémy. 8

11 Kapitola 4 Třídy pro správu dat 4.1 DataSet DataSet je základním stavebním prvkem každé složitější databázové aplikace. Jde o kompletní reprezentaci sady dat, která v sobě zahrnuje tabulky, vztahy mezi daty a omezení. S tím vším může DataSet pracovat v režimu offline (tedy odpojen od databázového systému). DataSet se nestará o připojení k databázi, jde pouze o objekt spravující data v paměti. DataSet může obsahovat data načtená nejen z databázových systémů, ale například i z xml souborů. K datům v DataSetu můžeme přistupovat, můžeme je upravovat, mazat nebo porovnávat s daty v původním datovém zdroji. Příklad vytvoření datasetu: DataSet dataset = new DataSet(); 4.2 DataTable DataTable (datová tabulka) ukládá data stejně jako to dělá tabulka v databázi. Data jsou umístěna v řádcích (rows) a každá položka v řádce přísluší konkrétnímu sloupci (column). Objekt DataTable může být používán samostatně, ale i jako součást objektu DataSet. DataTable se skládá z kolekce objektů Columns, kolekce objektů Rows a kolekce objektů Constraints. Kolekce Columns ve spojení s kolekcí Constraints definuje takzvané schéma objektu DataTable, zatímco kolekce Rows obsahuje data. Kolekce Columns Kolekce Columns je instancí třídy DataColumnCollection a jde o kontejner pro objekty typu DataColumn. Objekt DataColumn definuje sloupec datové tabulky včetně jeho jména, datového typu a informace o tom, zda jde o primární klíč či se jedná o autoinkrementační sloupec. Kolekce Rows Kolekce Rows je instancí třídy DataRowCollection a jde o kontejner pro objekty typu DataRow. Objekt DataRow obsahuje uložená data objektu Data- Table podle jejich definic v kolekci DataTable.Columns. Každá řádka DataRow obsahuje jednu položku pro každý sloupec DataColumn v kolekci Columns. 9

12 ADO.NET Kapitola 4 Kolekce Constraints Kolekce Constraints je instancí třídy ConstraintCollection a jde o kontejner pro objekty typu ForeignKeyConstraint a/nebo objekty typu UniqueConstraint. Objekt ForeignKeyConstraint definuje akci, která má být provedena na sloupec primárního nebo cizího klíče, pokud je řádek změněn nebo smazán. Objekt UniqueConstraint je používán k zajištění jedinečnosti všech hodnot ve sloupci. Příklad ručního vytvoření tabulky a její přidání do DataSetu: DataTable filmovatabulka = new DataTable("Filmy"); DataSet ds = new DataSet(); ds.tables.add(filmovatabulka); Události DataTable Následující události mohou být zachyceny a zpracovány při práci s objektem DataTable: Přehled událostí objektu DataTable RowChanging nastane při změně hodnoty v řádce RowChanged nastane po úspěšné změně řádky RowDeleting nastane při pokusu o smazání řádky RowDeleted nastane po úspěšném smazání řádky ColumnChanging nastane při změně hodnoty ve sloupci ColumnChanged nastane po změně hodnoty ve sloupci Příklad obsluhy události: //registrace udalosti filmovatabulka.columnchanging = new DataColumnChangeEventHandler(ColumnChangingHandler); // obsluzna metoda udalosti private void ColumnChangingHandler(object sender, DataColumnChangeEventArgs e) { // kod obsluhujici udalost } 4.3 DataColumn Objekt DataColumn definuje sloupec a jeho datový typ. Příklad vytvoření dvou sloupců pro tabulku filmovatabulka: filmovatabulka.columns.add("nazev",type.gettype ("System.String")); filmovatabulka.columns.add("rok",type.gettype ("System.Int32")); Vlastnosti sloupců Primary Key Databázová tabulka má obvykle definovaný sloupec (skupinu sloupců), které jedinečně identifikují každou řádku v tabulce. Takovémuto identifikátoru sloupce 10

13 ADO.NET Kapitola 4 (skupiny sloupců) se říká primární klíč. Vytvoření primárního klíče nad jedním sloupcem tabulky: DataColumn[] key = new DataColumn[1]; key[0] = filmovatabulka.columns["nazev"]; filmovatabulka.primarykey = key; Vytvoření primárního klíče nad více sloupci tabulky: DataColumn[] key = new DataColumn[2]; key[0] = filmovatabulka.columns["nazev"]; key[1] = filmovatabulka.columns["rok"]; filmovatabulka.primarykey = key; Autoinkrementace Autoinkrementační sloupec můžete nastavit přímo v databázovém systému nebo podle následujícího příkladu: // povoleni autoinkrementace filmovatabulka.columns["id"].autoincrement = true; // zacatek autoinkrementace filmovatabulka.columns["id"].autoincrementseed = 10; // krok pri autoinkrementaci filmovatabulka.columns["id"].autoincrementstep= 10; Nastavení sloupce pouze pro čtení Pokud nechcete uživateli povolit zápis dat do sloupce, nastavte vlastnost Readonly na hodnotu true dle následujícího příkladu: filmovatabulka.columns["id"].readonly = true; 4.4 DataRow Objekt DataRow obsahuje data pro jednu řádku datové tabulky. Příklad naplnění jednoho řádku tabulky filmovatabulka: //pomocna radka DataRow tmp; //nastaveni schematu pomocne radky tmp = filmovatabulka.newrow(); //nastaveni hodnoty pro sloupec nazev tmp["nazev"] = "Antitrust"; //nastaveni hodnoty pro sloupec rok tmp["rok"] = 2001; //pridani pomocne radky do tabulky filmovatabulka.rows.add(tmp); Constraints Relační databáze zajišťují integritu dat pomocí omezení (constraints). Tato omezení přesně definují, co se bude dít v případě, že data v souvisejícím sloupci či řádce jsou měněna. V ADO.NET existují dva druhy omezení: ForeignKeyConstraint a UniqueConstraint. 11

14 ADO.NET Kapitola 4 ForeingnKeyConstraint Toto omezení specifikuje akce, které mají být provedeny, pokud je hodnota ve sloupci či sloupcích smazána nebo upravena. Tento typ omezení je určen pro použití ve vztahu k primárnímu/cizímu klíči. Pokud je hodnota v rodičovském sloupci změněna nebo smazána, ForeignKeyConstraint definuje, co bude sloupec potomka v dané situaci dělat. Akce k provedení jsou definovány ve vlastnostech ForeignKeyConstraint.DeleteRule nebo ForeignKeyConstraint.UpdateRule a mohou bý nastaveny na tyto hodnoty: Rule.Cascade - smaže nebo upraví řádky ve vztahu (implicitní akce) Rule.SetNull - nastaví hodnoty ve vztažných řádkách na DBNull Rule.SetDefault - nastaví hodnoty ve vztažných řádcích na hodnotu vlastnosti DefaultValue Rule.None - na vztažné řádky nebudou provedeny žádné akce UniqueConstraint Toto omezení zajišťuje unikátní hodnoty v celém sloupci. Pokud se pokusíme zadat stejnou hodnotu do dvou řádků sloupce s omezením UniqueConstraint, bude vyvolána vyjímka. 4.5 DataRelation Objekt DataRelation umožňuje vytvořit vztah mezi dvěma objekty typu Data- Table pomocí jejich dvou sloupců. Jedná se prakticky o programové vytvoření vztahu primární klíč - cizí klíč. Příklad vytvoření relace mezi sloupci dvou tabulek: DataColumn parentcolumn; DataColumn childcolumn; // inicializace sloupcu parentcolumn = DataSet.Tables["Customers"]. Columns["CustID"]; childcolumn=dataset.table["orders"]. Columns["CustID"]; // vytvoreni relace DataRelation relationcustomersorders = new DataRelation ("CustomersOrders", parentcolumn, childcolumn); // pridani relace Dataset.Relations.Add(relationCustomersOrders); 4.6 DataColumnMapping a DataTableMapping Tyto objekty umožňují namapovat sloupcům tabulky nová jména pro jednodušší použití v databázových aplikacích. 12

15 Kapitola 5 Třídy pro připojení k databázi 5.1 Připojení k databázi (SqlConnection) Abychom mohli pracovat s databázovým systémem, musíme s ním nejdříve navázat spojení. Po připojení k databázovému serveru můžeme přenášet data mezi databází a naší aplikací. Po ukončení přenosu dat musíme spojení s databázovým serverem zase ukončit. Pro připojení k databázi potřebujeme vytvořit tzv. připojovací řetězec, který obsahuje základní data o připojení. Základní parametry připojovacího řetězce server název databázového serveru uid (UserID) jméno uživatele pwd (Password) heslo uživatele database název databáze Příklad připojení k databázovému serveru: 1 // řetězec pro připojení k databázovému serveru string connstring = "server=(local);uid=sa; pwd=heslo;database=test;"; // vytvoření objektu typu SqlConnection SqlConnection conn = new SqlConnection(connString); //otevření připojení conn.open(); // tady bude nějaká práce s databázovým serverem //uzavření spojení conn.close(); Druhý příklad ukazuje, jak se můžeme připojit k databázovému serveru pomocí syntaxe using. Při ukončení bloku uzavřeného příkazem using bude uzavřeno spojení s databází a zrušen objekt SqlConnection. Z tohoto důvodu nemusíme použít metodu Close(). 1 nezapomeňte připojit k programu jmenný prostor System.Data.SqlClient 13

16 ADO.NET Kapitola 5 // řetězec pro připojení k databázovému serveru string connstring = "server=(local);uid=sa; pwd=heslo; database=test;"; using (SqlConnection conn = new SqlConnection (connstring)) { //otevření připojení conn.open(); // tady bude nějaká práce s databázovým serverem } Předcházející příklad připojení k databázovému serveru je upřednostňovaný. Existují i další strategie připojování k databázovému serveru (například pomocí bloku try/catch/finally), ale těmi se již nebudu v této příručce zabývat. Poznámka 1: Chtěl bych upozornit, že veškerá vaše komunikace s databázovým systémem by měla být uzavírána do try/catch/ /finally bloků. S ohledem na názornost příkladů v této příručce však blok try/catch/finally na následujících stránkách neuvidíte. Poznámka 2: Ve všech následujících příkladech už budu předpokládat úspěšné připojení a odpojení databáze a budu se soustředit na vysvětlování konkrétních problémů. 5.2 Provádění SQL dotazů (SqlCommand) Objekt SqlCommand je používán pro spouštění dotazů na datovém zdroji. Rozeznáváme tři druhy dotazů: CommandType.Text - používá se pro textové zadání sql dotazu (implicitní nastavení) CommandType.TableDirect - používá se pro získání všech sloupců tabulky, jejíž jméno zadáme jako parametr CommandType.StoredProcedure - používá se pro volání uložených procedur Příkazy mohou být spouštěny čtyřmi různými způsoby : ExecuteNonQuery(), ExecuteReader(), ExecuteScalar() a ExecuteXml Reader(). Podrobněji se podíváme na první tři metody. Metoda ExecuteNonQuery() - provede příkaz a nevrací žádné výsledky - používá se pro spouštění editačních, vkládacích a odstraňovacích dotazů - vrací jedinou hodnotu, kterou je počet ovlivněných záznamů Příklad: // SQL dotaz string strcommand = "CREATE TABLE Filmy (nazev varchar, rok int)"; 14

17 ADO.NET Kapitola 5 // vytvoření objektu SqlCommand SqlCommand command = new SqlCommand(strCommand, conn); // provedení dotazu command.executenonquery(); // nastavíme nový SQL dotaz command.commandtext = "INSERT INTO Filmy values ( X-Files,1998)"; // příkaz vrací počet ovlivněných řádků int pocet = command.executenonquery(); Console.WriteLine("Pocet ovlivnenych radek: {0}", pocet); Poznámka: Mnohem zajímavější je vracení počtu ovlivněných záznamů například při příkazu UPDATE, v tomto případě jde pouze o demonstrační příklad. Metoda ExecuteReader() - provede příkaz a vrátí objekt, který implementuje rozhraní IDataReader - vrácený objekt můžeme procházet pomocí snímače dat (DataReader), který si podrobně popíšeme později Příklad: string strcommand = "SELECT nazev, rok FROM Filmy"; SqlCommand command = new SqlCommand(strCommand, conn); SqlDataReader reader = command.executereader(); while (reader.read()) { Console.WriteLine("{0} - {1}",reader[0], reader[1]); } Metoda ExecuteScalar() - provede příkaz a vrátí jednu hodnotu - používá se například pro určení počtu záznamů v tabulce Příklad: string strcommand = "SELECT COUNT(*) FROM Filmy"; SqlCommand command = new SqlCommand(strCommand, conn); // vrátí počet záznamů v tabulce Filmy int cislo = (int) command.executescalar(); Console.WriteLine(cislo.ToString()); 15

18 ADO.NET Kapitola 5 Uložené procedury Volání procedur provádíme taktéž pomocí objektu SqlCommand. Nejdříve musíme vytvořit proceduru v naší databázi. Zde je jednoduchý příklad uložené procedury pro SQL server: CREATE PROCEDURE InsertFilm(@nazev INTEGER) AS INSERT INTO Filmy VALUES Příklad použití uložené procedury: // nastaveni objektu SqlCommand SqlCommand command = new SqlCommand("InsertFilm"); command.connection = conn; command.commandtype = CommandType.StoredProcedure; command.parameters.add(new SqlParameter ("@nazev", SqlDbType.VarChar)); command.parameters.add(new SqlParameter ("@rok", SqlDbType.Int)); //spusteni ulozene procedury s parametry command.parameters[0].value="dune"; command.parameters[1].value=1984; command.executenonquery(); Poznámka: Tato procedura sice nemá hlubší smysl, neboť stejnou funkci splní jednoduchý SQL dotaz, ale pro ukázku postačí. 5.3 Datový adaptér (SqlDataAdapter) Už víme, jak se připojit k databázi. Také víme, že data jsou uložena v objektu DataSet. Jak ale data přenést z databáze do objektu DataSet? K tomuto účelu slouží objekt DataAdapter. DataAdapter tvoří imaginární most mezi daty v paměti (DataSet) a mezi daty v databázovém systému. Příklad načtení dat do objektu DataSet: DataSet ds = new DataSet(); SqlDataAdapter da = new SqlDataAdapter ("SELECT * FROM Filmy;", conn); //naplnění datasetu da.fill(ds,"filmy"); //výpis názvu sloupců v tabulce Filmy v datasetu foreach (DataColumn sloupec in ds.tables["filmy"]. Columns) { Console.WriteLine(sloupec.Caption.ToString()); } Aktualizace dat v databázi Pokud zavoláme metodu Fill datového adaptéru (DataAdapter), tak jsou data v objektu DataSet obnovena novými daty z databáze. Co ale budeme dělat v případě, že byla změněna data v DataSetu a chceme je nahrát zpět do databáze? V takovém případě máme dvě možnosti. 16

19 ADO.NET Kapitola 5 První možností je zachytávání stavů DataSetu a vytvoření vlastních SQL dotazů jako reakce na změnu jeho stavu. Každý řádek v DataSetu má vlastní hodnotu RowState, která je při načtení dat z databáze nastavena na Unchanged (nezměněn). Pokud do DataSetu přidáme nový řádek, je jeho vlastnost RowState nastavena na Added (přidán). Smazanému řádku 2 je nastavena hodnota Deleted (smazán). Upravenému řádku je nastavena hodnota Modified (změněn). Aktualizace SQL dotazy je často nahrazována uloženými procedurami. Druhou možností, jak postupovat v případě, že chceme změněná data v Data- Setu přenést do databázového systému je použití objektu SqlCommandBuilder, o kterém si povíme v následující kapitole. 5.4 Tvorba příkazů (SqlCommandBuilder) SqlCommandBuilder je objekt, který nám usnadňuje práci při přenosu změněných dat z objektu DataSet zpátky do databázového systému. SqlCommandBuilder provede analýzu příkazu SELECT v datovém adaptéru a následně pomocí něj vygeneruje SQL dotazy INSERT, UPDATE a DELETE. Pro použití objektu SqlCommandBuilder musíme splnit následující podmínky: 1. Datový adaptér musí mít definován příkaz SELECT. Ten můžeme nastavit buď v konstruktoru objektu DataAdapter nebo pomocí vlastnosti SelectCommand datového adaptéru. 2. V příkazu SELECT musí být zadán sloupec primárního klíče nebo sloupec s omezením unique. Příklad použití objektu SqlCommandBuilder pro aktualizaci dat v databázi: DataSet ds = new DataSet(); SqlDataAdapter da = new SqlDataAdapter ("SELECT * FROM Filmy;", conn); // SqlCommandBuilder připojený na datový adaptér SqlCommandBuilder cb = new SqlCommandBuilder(da); //naplnění datasetu da.fill(ds,"filmy"); //přidání nového záznamu do datasetu DataRow myrow; myrow = ds.tables["filmy"].newrow(); myrow[0] = "XXX"; myrow[1] = 2000; ds.tables["filmy"].rows.add(myrow); // update dat v databázi da.update(ds, "Filmy"); 5.5 Snímač dat (SqlDataReader) Objekt SqlDataReader reprezentuje nejjednodušší přístup k datům v databázi. Jeho jednoduchost je však vykoupena několika nevýhodami. DataReader může 2 Řádek není fyzicky vymazán, jen je mu nastaven příznak a není zobrazován 17

20 ADO.NET Kapitola 5 pracovat pouze s připojenou databází, tzn. že je potřebné kvalitní připojení k databázi. DataReader může v jednom okamžiku pracovat pouze s jednou řádkou v databázi. K výhodám naopak patří, že DataReader ke své činnosti nevyžaduje DataSet, data mohou být například vypisována na monitor nebo zpracovávána jiným způsobem. DataReader si můžeme představit jako jednosměrný databázový kurzor. Příklad použití objektu DataReader: // příkaz pro DataReader SqlCommand command = new SqlCommand ("SELECT * FROM Filmy",conn); //spuštění příkazu SqlDataReader reader = command.executereader(); //načítání a výpis dat while (reader.read()) { Console.WriteLine("{0} - {1}", reader.getvalue(0), reader.getvalue(1)); } //ukončení čtení reader.close(); 5.6 Transakce (SqlTransaction) Transakce jsou používány v případě, že chceme spustit více příkazů najednou, které mají být provedeny jako jedna nedělitelná transakce. Příklad provedení tří příkazů najednou: // začátek transakce SqlTransaction trans = conn.begintransaction(); // nastavení objektu SqlCommand SqlCommand command = conn.createcommand(); command.connection=conn; command.transaction=trans; command.commandtext = "INSERT INTO Filmy VALUES ( American Pie,1999)"; command.commandtext = "INSERT INTO Filmy VALUES ( American Pie 2,2001)"; command.executenonquery(); command.commandtext = "INSERT INTO Filmy VALUES ( American Pie 3,2004)"; command.executenonquery(); // potvrzení transakce trans.commit(); 18

21 Kapitola 6 XML Jak už jsem napsal dříve, XML je využíváno v ADO.NET při většině interních operací. V této kapitole si ukážeme pouze základní operace, kterými je načtení dat ze souboru typu XML do objektu DataSet a uložení objektu DataSet do XML souboru. XML poskytuje mnoho dalších zajímavých záležitostí, např. pomocí schémat dokumentu XML (XSD) vám může program automaticky vygenerovat zdrojový kód ve vašem programovacím jazyce, který vytvoří tabulky dle schématu. Bohužel toto téma již přesahuje rámec této příručky. Uložení databáze do souboru XML Pokud máme v paměti vytvořený objekt DataSet, můžeme ho jednoduše uložit do XML souboru. Buď můžeme do XML souboru uložit pouze data, nebo může být v souboru ještě uvedeno schéma DataSetu. Uložení bez schématu provedeme příkazem (ds je instance objektu DataSet): ds.writexml("data.xml"); Uložení včetně schématu provedeme příkazem: ds.writexml("data2.xml", XmlWriteMode.WriteSchema); Vytvoření databáze ze souboru XML Načtení dat do DataSetu z XML souboru je velice jednoduché. Stačí napsat následující řádky: DataSet ds = new DataSet(); ds.readxml("data.xml"); Je úplně jedno, zda XML soubor obsahuje schéma či nikoliv. V případě, že jsou v souboru pouze data, tak si strukturu objekt DataSet vytvoří sám podle uspořádání těchto dat. 19

22 Kapitola 7 Visual Studio.NET V této kapitole se podíváme na to, jak nám ulehčuje přístup k databázím programovací prostředí Visual Studio.NET. Po spuštění aplikace Visual Studio a vytvoření nového projektu typu Windows Application naleznete po pravé straně pracovní plochy lištu ToolBox. Na ní se nachází paleta Data, která obsahuje komponenty pro práci s databázemi. Jsou to komponenty pro správu dat (DataSet a DataView) a komponenty pro přístup k databázím (Connection, Command a DataAdapter). Komponenty pro přístup k databázím existují v několika verzích - s předponou Sql (pro SQL Server a MSDE), OleDb (pro databázové systémy připojené pomocí ovladače OleDb), Odbc (pro databázové systémy připojené pomocí ovladače Odbc, což je předchůdce ovladače OleDb) a Oracle (speciální ovladač pro databázový systém Oracle). V dalším textu budu opět pracovat s databázovým systémem MSDE, a proto budou názvy objektů začínat předponou Sql. 7.1 Připojení k databázi (SqlConnection) Připojení k databázi provedeme pomocí následujícího postupu. Nejdříve si vytvoříme připojení na náš databázový server. Nad lištou ToolBox se nachází lišta označená jako Server Explorer. Po jejím otevření vybereme položku Data Connections a klikneme na ní pravým tlačítkem. Vzápětí vybereme položku Add Connection... Otevře se formulář, ve kterém postupně nastavíme připojení ke zvolené databázi. Jako název serveru můžeme napsat (local), což znamená, že se připojujeme k databázi běžící na tomto počítači, nebo adresu serveru s databází. Vyplníme kolonky Uživatelské jméno a Heslo a zašktneme políčko Povolit uložení hesla, abychom nemuseli tyto údaje zadávat při běhu programu. Nyní si můžeme vybrat pomocí rozbalovacího menu databázi, ke které se chceme připojit. Případně si můžeme spojení ještě otestovat kliknutím na tlačítko Testovat připojení. Po potvrzení voleb se nám pod položku Data Connections přidalo první připojení na databázi. Takovýchto připojení si můžeme vytvořit libovolné množství. Nespornou výhodou tohoto postupu je fakt, že Visual Studio má jednotlivá připojení trvale uložena, takže je můžete použít i pro vývoj dalších aplikací. Pokud je připojení nastaveno, můžeme připojit databázi k naší aplikaci. Pro připojení se používá komponenta SqlConnection. 20

23 ADO.NET Kapitola 7 Důležité vlastnosti komponenty SqlConnection Name název komponenty ConnectionString připojovací řetězec můžete buď vybrat z menu, pokud jste si vytvořili připojení popsané v předcházejícím odstavci, nebo zadat ručně Database vrací název databáze DataSource vrací název instance SQL serveru ServerVersion vrací verzi instance SQL serveru, ke kterému jste připojeni WorkstationId vrací název klientské stanice Důležité metody komponenty SqlConnection Open() otevření spojení s databází Close() uzavření spojení s databází 7.2 Provádění SQL dotazů (SqlCommand) Pro tvorbu SQL dotazu slouží ve Visual Studiu komponenta SqlCommand. Nejdůležitější vlastnosti komponenty SqlCommand Name název komponenty CommandText SQL dotaz CommandType nastavení typu dotazu (Text, StoredProcedure, TableDirect) Connection připojení k databázi (instance objektu SqlConnection) Nejdůležitější metody komponenty SqlCommand ExecuteNonQuery() provedení příkazu bez vrácení výsledku ExecuteScalar() provedení příkazu s návratem jedné hodnoty ExecuteReader() provedení příkazu s návratem objektu implementujícího rozhraní IDataReader 7.3 Datový adaptér (SqlDataAdapter) Po přidání komponenty SqlDataAdapter na plochu formuláře se spustí průvodce, který nám pomůže s nastavením této komponenty. Po odklepnutí úvodního informačního okna přejdeme na další, ve kterém vybereme připojení (SqlConnection), které již máme vytvořeno, případně vytvoříme nové. Na další obrazovce musíme nastavit způsob aktualizace dat v databázi (pomocí SQL dotazů, vytvořením nových uložených procedur či použitím již existujících procedur). Pro jednoduchost zvolíme aktualizaci pomocí SQL dotazů (Use Sql Statements). Na další obrazovce můžeme pomocí aplikace Query Builder vytvořit SQL dotaz (typu SELECT) či ho zapsat ručně. Poslední obrazovka už jen informuje, zda se vše povedlo nebo ne. Ukázka kódu (naplnění objektu typu DataSetu pomocí objektu typu DataAdapter): sqldataadapter1.fill(dataset1); 21

24 ADO.NET Kapitola DataSet DataSet opět nalezneme na paletě Data lišty ToolBox. Nejdůležitější vlastnosti komponenty DataSet Name název komponenty DataSetName pojmenování instance DataSetu Relations kolekce relací mezi tabulkami Tables kolekce tabulek Nejdůležitější metody komponenty DataSet AcceptChanges provedení změn RejectChanges odmítnutí změn ReadXml(string filename) načtení dat z XML do DataSetu WriteXml(string filename) uložení dat z DataSetu do XML 7.5 DataView Komponentu DataView najdeme stejně jako předcházející komponenty na paletě Data. Tato komponenta nám umožňuje vybírat data z DataSetu podle různých filtrovacích dotazů. Nejdůležitější vlastnosti komponenty DataView Name název komponenty Table specifikuje tabulku, nad kterou vytvoříme pohled AllowDelete specifikuje možnost mazat data AllowEdit specifikuje možnost upravovat data AllowNew specifikuje možnost vytvářet data RowFilter filtr řádek (např.: rok=1998) RowStateFilter filtr stavu řádek (Unchanged, New, Deleted) Nejdůležitější metody komponenty DataView AddNew() přidání nové řádky Delete(int index) smazání řádky na zadaném indexu 7.6 DataGrid DataGrid je jediná vizuální komponenta, kterou si v této příručce představíme. Komponentu nenalezneme na paletě Data, nýbrž na paletě Windows Forms. Jde o datovou tabulku, která reprezentuje data vizuálně stejným způsobem jako jsou data uložena v databázi. DataGrid může zobrazovat data uložená v komponentách DataSet nebo DataView. Nejdůležitější vlastnosti komponenty DataGrid Name název komponenty AllowSorting umožní řazení dat kliknutím na název sloupce, dle kterého chceme řadit DataMember zobrazení pouze vybrané tabulky DataSetu DataSource zdroj dat (DataSet nebo DataView) ReadOnly nastavení komponenty pouze pro čtení 22

25 Kapitola 8 Závěr ADO.NET je pravděpodobně nejefektivnější způsob přístupu k databázovým systémům současnosti. Pokud tedy umíte některý z programovacích jazyků podporovaných platformou.net, nemůžete zvolit lépe. Přehled základní práce s databázovými systémy jsem se pokusil přiblížit v této příručce. 23

26 Příloha A Úvod do MSDE A.1 Instalace MSDE 1. Databázový systém MSDE si můžete stáhnout zcela zdarma z následující adresy: downloads/download.asp. 2. Soubor MSDE2000A.exe je samorozbalovací archív, který si rozbalte do libovolného adresáře. 3. Nyní musíte spustit soubor setup.exe s parametry, které definují způsob instalace. Pokud se vám nechce pročítat nápovědu, spusťte soubor následujícím příkazem (pro základní použití zcela postačuje): setup.exe SA- PWD= heslo SECURITYMODE=SQL. 4. Následuje tichá instalace programu. 5. Po skončení instalace a případném restartu systému již můžete přistupovat k databázovému serveru jako uživatel sa s heslem, které jste zadali ve třetím kroku. Běh MSDE indikuje ikonka databáze se zelenou šipkou v trayi. A.2 Práce s MSDE Systému MSDE můžete zadávat SQL dotazy pomocí konzolové aplikace. Tuto aplikaci najdete při standardní instalaci v adresáři C:\Program Files\Microsoft SQL Server\80\Tools\Binn. Program má název OSQL.exe a nejjednodušeji ho spustíte příkazem OSQL.exe -U username -P password, kde username je vaše uživatelské jméno a password je vaše heslo. A.3 Příprava základní databáze aneb rychlokurz SQL Po spuštění konzolové aplikace si nejdříve vytvoříme novou databázi. Zadáme příkaz create database Test a stiskneme klávesu Enter. 1 Program nám vypíše údaje o vytvoření databáze a jejího log souboru. Nyní se do databáze přepneme pomocí příkazu use Test. Vytvoříme jednoduchou tabulku pomocí SQL dotazu CREATE TABLE Filmy(nazev varchar(50) PRIMARY KEY, rok int);. 1 Připomínám, že MSDE je free verzí MS SQL Serveru, takže musíme po každém SQL dotazu zapsat ještě příkaz go a stisknout klávesu Enter. 24

27 ADO.NET Příloha A Pro tento příklad budeme předpokládat, že každý film má unikátní název. Do tabulky vložíme jeden záznam následujícím SQL dotazem: INSERT INTO Filmy VALUES( X-Files, 1998);. Dotazem SELECT * FROM Filmy; se přesvědčíme, že je naše testovací tabulka s daty vytvořena. A.4 Správa MSDE Ke spravování a konfiguraci databázového systému MSDE můžete využít různé programy, např. DbaMgR2k nebo MSDE Manager for.net. 25

28 Literatura [1] Simon Robinson, K. Scott Allen, Ollie Cornes, Jay Glenn, Zach Greenvoss, Burton Harvey, Christian Nagel, Morgan Skinner, Karli Watson, C# Programujeme profesionálně, Wrox, Computer Press. [2] Dalibor Kačmář, Programujeme.NET aplikace ve Visual Studiu.NET, Computer Press. [3] Luboslav Lacko, SQL Hotová řešení, Computer Press. 26