ADO.NET - note de curs pentru disciplina "Servere de date"

Transcription

1 ADO.NET - note de curs pentru disciplina "Servere de date" Pentru lucrul cu sursele de date necesare într-o aplicaţie se poate folosi ADO.NET, care este o ierarhie de clase ce permite gestiunea datelor. In tabelul 1 sunt enumerate aceste clase. Intr-o aplicatie se poate include un obiect din ierarhia Ado.Net prin: selectarea lui din toolbox-ul Data (dacă se lucrează cu Visual Studio, iar stabilirea valorilor pentru proprietăţi se face uşor) prin cod (declararea unei variabile, construirea obiectului, stabilirea de valori pentru proprietăţi, folosirea de metode). Pentru a se putea lucra cu o bază de date este necesară conectarea la aceasta, cu ajutorul unui obiect Connection. După ce o conecţiune s-a deschis cu succes, se poate executa o comandă (instrucţiune SQL) la acestă sursă de date, cu ajutorul unui obiect Command. Extragerea de date din sursa de date se poate realiza cu un obiect DataReader (cu restricţia că datele astfel obţinute se pot folosi numai "forward-only" şi "read-only", adică se poate face parcurgerea numai o dată de la început spre sfârşit şi se pot numai citi date). Datele dintr-o bază de date se pot gestiona şi cu obiecte DataTable construite prin cod sau cu ajutorul obiectelor DataAdapter (obiectele DatTable sunt incluse in obiecte DataSet). Pentru gestiunea bazelor de date se pot folosi următoarele tipuri de drivere: ODBC, unde bazele de date sunt relaţionale. Există drivere pentru foarte multe surse de date OleDb - prin anumite extensii ale modelului relaţional (unele drivere ODBC au fost rescrise) Drivere scrise (şi optimizate) pentru servere de date: SQL Server, Oracle,... Corespunzător tipului de driver folosit pentru gestiunea sursei de date, există câte patru tipuri de obiecte pentru: Connection, Command, DataReader, DataAdapter (cele care lucrează efectiv cu sursele de date): 1. Pentru o bază de date Microsoft SQL Server: SQLConnection, SQLCommand, SQLDataReader, SQLDataAdapter 2. Pentru o bază de date Oracle: OracleConnection, OracleCommand, OracleDataReader, OracleDataAdapter 3. Pentru o bază de date la care accesul se face cu OLE DB: OleDbConnection, OleDbCommand, OleDbDataReader, OleDbDataAdapter 4. Pentru o bază de date la care accesul se face cu ODBC: ODBCConnection, ODBCCommand, ODBCDataReader, ODBCDataAdapter Obs. Pentru gestiunea bazelor de date SQL Server sau Oracle se pot folosi şi obiectele amintite la punctele 3 şi 4. Obiectele Connection se crează, prin cod, folosind constructorul clasei, de ex: Dim conn as New OleDbConnection Proprietăţi şi metode utile pentru obiectele Connection: ConnectionString - şirul de conectare la sursa de date ConnectionTimeout - timp maxim de conectare Open( ) - deschiderea conecţiunii Close( ) - închiderea conecţiunii Dispose( ) - eliberarea spaţiului de memorie ocupat de conecţiune Pentru a se putea deschide o conecţiune la o bază de date sunt necesare anumite informaţii ce se pot preciza în proprietatea ConnectionString. In continuare se dau câteva exemple de astfel de valori pentru conectarea la diferite surse de date. Se observă că la baze de date SQL Server sau Oracle se poate face conectarea prin obiectele de conectare specifice acestor surse de date, sau prin folosirea obiectelor OleDbConnection (apare în şirul de conectare şi o valoare pentru Provider) sau ODBCConnection. Prin folosirea claselor personalizate de acces la bazele de date SQL Server sau

2 Oracle se obţin viteze mai mari de lucru. Sirul de conectare se poate construi cel mai simplu dacă se lucrează în ASP.NET şi conecţiunea se stabileşte interactiv. In şirul de conectare se pot folosi şi valori pentru autentificare: "user id=x;password=y", dacă nu se doreşte un dialog pentru autentificare. Un astfel de sir de conectare se poate construi şi prin cod. Pentru SQL Server: "Persist Security Info=False;Integrated Security=SSPI; database=studenti; server=sql; Connect Timeout=30" Pentru Oracle: "Data Source=Oracle; Integrated Security=yes" Pntru surse de date OLE DB: "Provider=MSDAORA; Data Source=ORACLE;Persist Security Info=False;Integrated Security=yes" "Provider=Microsoft.Jet.OLEDB.4.0; Data Source=d:\bd\Studenti.mdb" "Provider=SQLOLEDB;Data Source=SQL;Integrated Security=SSPI" Pentru surse de date ODBC: "Driver={SQL Server};Server=MyServer;Trusted_Connection=yes;Database= studenti;" "Driver={Microsoft ODBC for Oracle};Server=ORACLE;Persist Security Info=False; Trusted_Connection=yes" "Driver={Microsoft Access Driver (*.mdb)};dbq= d:\bd\studenti.mdb;driverid=790" "Driver={Microsoft Excel Driver (*.xls)};dbq=d:\bd\studenti.xls" "Driver={Microsoft Text Driver (*.txt; *.csv)};dbq=d:\bd" "DSN=dsnname" O conecţiune se poate deschide cu metoda Open( ) şi închide cu metoda Close( ). La deschiderea unei conecţiuni se rezervă o zonă de memorie ce poate fi eliberată prin metoda Dispose(). In continuare se dă un exemplu de lucru prin cod. Pentru a crea obiectul conn este necesar spaţiul de nume System.Data.OracleClient, care se precizează astfel: Pentru ASP.NET: <%@ Import Namespace="System.Data" %> <%@ Import Namespace="System.Data.OracleClient" %> Definire, construire, configurare, deschidere: dim conn as New OracleConnection conn.connectionstring=""data Source=Oracle; Integrated Security=yes;user id=x;password=y " conn.open() Pentru stabilirea conecţiunii se foloseşte un timp maxim de conectare. Valoarea implicită se poate schimba cu proprietatea ConnectionTimeout (dacă în intervalul de timp nu se poate stabili conecţiunea, atunci se generează o excepţie). La o conecţiune deschisă se poate executa o comandă printr-un obiect Command (prefixul: SQL, Oracle, OleDb, ODBC), trebuie să fie acelaşi cu cel al conecţiunii). La început trebuie creat acest obiect: Dim com as New OleDbCommand Printre proprietăţile acestui obiect sunt: CommandText - prin care se precizează comanda ce se execută

3 CommandTimeout - se specifică intervalul de timp în care trebuie să execute comanda. Dacă nu se poate executa în acest interval de timp, se generează o eroare. CommandType - precizează tipul comenzii (cum trebuie interpretat şirul de caractere din proprietatea CommandText). Valoarea acestei proprietăţi poste fi: 1. StoredProcedure - dacă se cere execuţia unei proceduri memorate în baza de date. Eventualii parametrii din procedură se specifică prin Parameters. 2. TableDirect (numai pentru obiect OleDb) - dacă valoarea din CommandText este denumirea unui tabel din baza de date. 3. Text - dacă şirul din CommandText este o instrucţiune SQL. Connection - precizează un obiect conecţiune (la baza de date deschisă de acest obiect se va executa comanda) Dintre metodele unui obiect command amintim: ExecuteNonQuery() - dacă se cere execuţia unei comenzi ce nu furnizează date pentru client (ex. o instrucţiune insert) ExecuteScalar() - dacă instrucţiunea furnizează o singură valoare (un set cu o linie şi o coloană). Poate fi considerată ca o funcţie ce furnizează o valoare, ca în exemplul următor: Dim nrstud As New OleDbCommand nrstud.commandtext="select Count(*) FROM Studenti" nrstud.connection=cons Dim nr As Int32 = CInt(nrstud.ExecuteScalar()) ExecuteReader() - dacă va rezulta un obiect DataReader Cancel() - pentru anularea execuţiei comenzii Atunci când se cere execuţia unei comenzi (cu un obiect Command) se precizează o instrucţiune SQL, un nume de procedură, un nume de tabel în proprietatea CommandText. In comandă pot să apară şi parametri. Un astfel de parametru: are un nume şi este precedat de "@" pentru SQLCommand (exemplu: "Select * from studenti where sectia=@sectia and anstudiu=@an") are un nume şi este precedat de ":" pentru OracleCommand (exemplu: "Select * from studenti where sectia=:sectia and anstudiu=:an") este precizat prin "?" în OleDbCommand sau OdbcCommand (exemplu: "Select * from studenti where sectia=? and anstudiu=?") Un obiect Command are o colecţie de parametri, care formează colecţia Parameters. In funcţie de tipul comenzii (SQL, Oracle, OleDb, ODBC), colecţia Parameters conţine obiecte de tipul următor pentru fiecare parametru folosit în comandă (instrucţiune SQL sau parametru de intrare/ieşire, sau valoare, pentru o procedură memorată): SQLParameter, OracleParameter, OleDbParameter, sau OdbcParameter. Un astfel de obiect trebuie creat (cu un nume sau cu o poziţie în colecţia Parameters), să i se precizeze un tip (şi eventual lungimea) pentru valori, direcţia în care va fi folosit. Acest lucru se poate realiza prin constructorul clasei (ca parametri la constructor putem avea, în această ordine: numele, tip, lungime, sourcecolumn,...) sau prin constructor şi proprietăţi. Dintre proprietăţile acestor obiecte amintim: ParameterName - numele parametrului (pentru SQLParameter, OracleParameter) Tipul parametrului: OracleType, SQLType, OleDbType, ODBCType - tipul valorilor parametrului şi depinde de tipul obiectului. Valoarea trebuie calificată cu OracleType, SqlDbType, OleDbType, sau ODBCType. Dintre valori amintim: Char, Integer sau Int32, Single sau Float, VarChar, etc. Direction - modul în care este folosit parametrul: Input (parametru de intrare), InputOutput (parametru de intrare/iesire), Output (parametru de iesire), ReturnValue (valoare dată de o procedura memorată) IsNullable - parametrul poate avea sau nu valori nedefinite Size - lungime maxima in octeti Precision - numarul total de cifre pentru valoare

4 Scale - numarul de cifre zecimale pentru valoarea Value - valoarea parametrului Colecţia Parameters are, printre altele, şi următoarele proprietăţi şi metode: Count numarul de parametri din colectie Add (obiectparametru) adaugarea parametrului la colecţie Clear ( ) sterge toţi parametrii din colectie Contains (obiectparametru sau numeparametru) - daca colectia contine parametrul specificat Remove (obiectparametru) elimina parametrul specificat din colectie Observaţie. Ordinea de adăugare a parametrilor în colecţie precizează şi indexul pe care se memorează. Acest lucru este important la obiectele OleDbParameter, sau OdbcParameter, unde parametri nu se precizează prin nume ci prin poziţia pe care apar în CommandText. Exemplu de folosire: Dim comi as New OleDbCommand comi.commandtext="insert into studenti(nrmatricol,nume,prenume,grupa) values (?,?,?,?)" comi.parameters.add("", OleDbType.Char, 10) comi.parameters(0).value="1234" comi.parameters.add("", OleDbType.Char, 20) comi.parameters(1).value="popescu" comi.parameters.add("", OleDbType.Char, 20) comi.parameters(2).value="ioan" comi.parameters.add("", OleDbType.Char, 3) comi.parameters(3).value="xxx" comi.connection=cons comi.executenonquery() Un obiect DataReader (construit cu metoda ExecuteReader a unui obiect Command): Dim s as OleDbDataReader = com.executereader() se poate folosi pentru parcurgerea o singură dată a unei mulţimi de date. Există o linie curentă în obiect (deci din sursa de date se află în memorie o singură linie), care iniţial este prima linie. Trecerea la următoarea linie se face cu metoda Read (această metodă dă valoarea false dacă nu există o astfel de linie). In linia curentă există un număr de coloane (câmpuri), precizat de proprietatea FieldCount. O coloană de pe o anumită poziţie se poate folosi cu proprietatea Item. O astfel de coloană are o valoare ce se poate obţine cu o mulţime de metode, după tipul valorii. Amintim metodele: GetSQLString (sau GetString pentru obiectul OleDbDataReader) - care furnizează valoarea coloanei ca un şir de caractere, GetFloat, GetChar, GetDateTime, etc. Denumirea coloanei se poate afla cu metoda GetName(index). Cu metoda IsDBNull se află dacă valoarea coloanei este null sau nu. Cu metoda Close( ) se poate închide obiectu. Valorile obţinute într-un obiect DataReader se pot folosi în două feluri: 1. Prin parcurgerea mulţimii de valori şi extragerea lor în pagina html generată pentru client (de exmplu într-un control table, unde fiecare linie din mulţimea de date va genera o linie în table). In acest fel se poate controla foarte uşor modul de extragere a datelor. 2. La ASP.NET: prin legarea datelor de un control de server DataList sau DataGrid. Acest mod de folosire este foarte avantajos deoarece nu trebuie scris mult cod, se precizează controlul de server folosit, iar pentru acest control se fac următoarele două acţiuni (prin cod, de exemplu în evenimentul Load pentru pagina): la proprietatea DataSource se atribuie obiectul DataReader, după care se apeleadă metoda DataBind (pentru control). Cu obiectul DataSet din ADO.NET se poate gestiona o mulţime de date (o baza de date) considerată că se păstrează în memoria internă (deci fără legătură cu sursa de date). In acest caz datele se copiază de pe suport în memoria internă şi după aceasta nu mai este necesară o conecţiune la sursa de date.

5 După crearea obiectului DataSet: Dim s As DataSet = New DataSet("dataset1") se pot adăuga obiecte DataTable, care reprezintă o mulţime de înregistrări (păstrate în memoria internă) dintr-o anumită sursă de date. La un DataSet se pot adăuga obiecte DataTable din surse diferite de date. Intre două obiecte DataTable se poate defini o legătură (asemănător unei legături prin cheie externă într-o bază de date) printr-un obiect DataRelation. DataSet DataTable DataTable SelectCommand DataAdapter InsertCommand DeleteCommand UpdateCommand Baza de date Dintre proprietăţile şi metodele clasei DataSet amintim: DataSetName - numele obiectului Tables - colecţia de tabele (obiecte DataTable) inclusă în obiect Relations - colecţia de relaţii (obiecte DataRelation) dintre tabele Clear( ) - şterge toate datele din toate tabelele incluse în obiect Un obiect DataSet poate fi tipizat (typed) sau netipizat (untyped). Deosebirea dintre cele două tipuri de obiecte constă în modul de referire la tabelele incluse şi la coloanele acestor tabele: Intr-un DataSet netipizat tabelele şi coloanele sunt gestionate prin intermediul unor colecţii (se foloseşte un index pentru referire), în timp ce la un DataSet tipizat tabele şi coloanele sunt referite ca proprietăţi ale obiectului (de aici avantajele pe care le aduce la lucrul interactiv cu Visual Studio). Exemplu: DataSet1.Tables["Studenti"] DataSet1.Studenti Pentru crearea unui DataSet tipizat trebuie să existe o clasă părinte (din care se obţine noua clasă) Un obiect DataSet conţine o colecţie de obiecte DataTable (tabele obişnuite dintr-o bază de date relaţională). Un obiect DataTable: Se poate crea prin cod. In acest caz se defineşte fiecare coloană din schema tabelului. Un tabel creat în acest fel se poate folosi independent sau să fie inclus într-un DataSet. Se foloseşte un obiect DataAdapter. In acest caz el se va include într-un DataSet. Dintre proprietăţile şi metodele unui obiect DataTable amintim: TableName - numele obiectului Columns - colecţia de coloane din care se compune tabelul Rows - colecţia de linii (înregistrări) incluse în tabel Clear( ) - elimină toate datele din tabel După definirea şi crearea unui obiect DataTable prin cod, acesta nu conţine coloane. Gestiunea coloanelor se poate face cu ajutorul unor obiecte DataColumn, iar adăugarea de linii la tabel se poate realiza cu obiecte DataRow. Un obiect DataColumn are şi următoarele proprietăţi: AllowDBNull - dacă se permite valoarea null Caption - precizează textul pentru capul de coloană

6 ColumnName - numele coloanei DataType - precizează tipul coloanei. Putem avea următoarele tipuri de date: Boolean, Byte, Char, DateTime, Decimal, Double, Int16, Int32, Int64, SByte, Single, String, TimeSpan, UInt16, UInt32, UInt64. Această denumire pentru tipul unei coloane se foloseşte prin intermediul clasei System (de exemplu System.String). Ca valoare a proprietăţii DataType nu se foloseşte o astfel de constantă, ci valoarea obţinută printr-o construcţie de tipul: System.Type.GetType("System.String") DefaultValue - valoarea implicită a coloanei După definirea unui obiect DataColumn, el se poate adăuga la colecţia de coloane a unui DataTable prin: obiectdatatable.columns.add(obiectcoloana). Din lista coloanelor unui tabel se pot elimina coloane cu metoda Remove(numeColoana), iar numărul de coloane se poate determina cu proprietatea Count. După crearea obiectului DataSet este necesară adăugarea de tabele (obiecte DataTable) la DataSet. Această operaţie se poate face astfel: 1. Cu ajutorul obiectelor DataAdapter 2. Construirea prin cod a tabelului şi adăugarea lui la colecţia de tabele, ca în exemplul de mai sus. 3. Folosirea unui document XML 4. Folosirea unui alt obiect DataSet Obiectul DataSet are proprietatea Tables, care precizează colecţia de tabele incluse în obiect. Această colecţie are metodele: Add(DataTable) - pentru adăugarea unui tabel (eventual creat prin cod) Remove(DataTable), sau Remove(numeDataTable) - pentru eliminarea unui tabel din colecţie Clear( ) - elimină toate tabelele Contains(numeDataTable) As Boolean - prezează dacă tabelul cu numele dat este în colecţie Numărul de tabele din colecţie se poate determina cu proprietatea Count. Crearea şi adăugarea unui obiect DataTable la un DataSet, prin cod, se vede în exemplul următor: Dim s As DataSet = New DataSet("dataset1") Dim t as New DataTable("Persoane") Dim c1 as New DataColumn,c2 as New DataColumn c1.columnname="cod" c1.datatype=system.type.gettype("system.string") t.columns.add(c1) c2.columnname="nume" c2.datatype=system.type.gettype("system.string") t.columns.add(c2) s.tables.add(t) Un obiect DataAdapter reprezintă o interfaţă între un DataSet şi o bază de date. Cu ajutorul unui astfel de obiect se poate adăuga un DataTable la un DataSet. Dintre proprietăţile şi metodele acestui obiect amintim numai: SelectCommand - pentru a preciza o comandă care permite generarea unui DataTable Fill(numeDataSet, numedatatable) - care determină datele şi le include ca un obiect DataTable într-un DataSet. Exemple de folosire: Dim da1 As New OleDbDataAdapter da1.selectcommand = com da1.fill(s,"gr243") da1.selectcommand.commandtext="select * FROM studenti where anstudiu=4" da1.selectcommand.commandtype=commandtype.text da1.selectcommand.connection=cons da1.fill(s,"an4") x = "SELECT * FROM studenti where sex='b'"

7 Dim da2 As New OleDBDataAdapter(x, cons) da2.fill(s,"baieti") Un obiect DataAdapter foloseşte un obiect Command pentru a selecta date dintr-o sursă de date şi cu metoda Fill le va trimite într-un DataTable, unde denumirea coloanelor va fi cea determinată de obiectul Command. Dacă în DataTable se doresc alte denumiri de coloane, atunci se poate construi o colecţie de obiecte DataTableMapping (ce va fi valoare pentru proprietatea TableMappings a obiectului DataAdapter) ce definesc corespondenţe între denumirea coloanelor sursă de date şi denumirea coloanelor destinaţie (în DataTable). Datele dintr-un obiect DataTable se pot gestiona (adăugarea de linii, ştergerea de linii, modificarea valorilor) cu ajutorul obiectelor DataRow. Un obiect DataRow trebuie definit, ca în exemplul următor: Dim dr as DataRow dr=obiectdatatable.newrow() după care se pot face atribuiri de valori la diferitele coloane: dr("nume_coloana") = valoare dr(index_coloana) = valoare dr(obiectdatacolumn) = valoare După definirea unui obiect DataRow şi atribuirea de valori la diferitele coloane, el se poate adăuga la colecţia de linii a unui DataTable prin: numedatatable.rows.add(obiectlinie). O linie dintr-un DataTable se poate şterge din colecţia Rows de linii cu metoda Remove(DataRow), sau se poate folosi metoda Delete() pentru obiectul DataRow. Stergerea tuturor liniilor se poate face prin metoda Clear(). Numărul de linii din colecţia Rows se poate determina prin metoda Count. Colecţia Rows are şi metoda Find ce permite căutarea unei linii după valorile coloanelor incluse în cheia primară. Colecţia Rows se poate folosi pentru parcurgerea înregistrărilor dintr-un DataTable, ca în exemplul următor: 'Parcurgere folosind colectia Rows cu "for each" Dim r as DataRow for each r in ds.tables("tabel1").rows... next 'Parcurgere folosind colectia Rows cu indice Dim i as integer for i=0 to ds.tables("tabel1").rows.count-1 r=ds.tables("tabel1").rows(i)... Next Pentru stabilirea unei legături între două tabele dintr-un DataSet (legătură de tipul 1:n între un tabel "părinte" şi un tabel "fiu") se foloseşte un obiect DataRelation. O astfel de relaţie este stabilită prin precizarea a câte unei mulţimi de coloane din cele două tabele amintite, care se compară prin egalitate (coloană din tabelul parinte cu coloană corespunzătoare în tabelul fiu). O astfel de legătură se poate folosi într-un mod analog cheii externe dintr-o bază de date obişnuită. Un obiect DataRelation are şi următoarele proprietăţi: RelationName - numele legăturii ParentTable - tabelul parinte (obiect DataTable) ChildTable - tabelul fiu ParentColumns - şirul de coloane din tabelul parinte folosit pentru legătură ChildColumns - şirul de coloane din tabelul fiu folosit pentru legătură După declararea unei variabile de tipul DataRelation: Dim leg as DataRelation se va construi un obiect de acest tip prin constructorul DataRelation astfel:

8 leg=new DataRelation("leg1",c1,c2) unde "leg1" este numele legăturii, iar c1 şi c2 sunt coloane (sau şiruri de coloane) din tabelul parinte şi respectiv fiu. Exemplu de folosire: Dim leg as DataRelation c1=s.tables("sectii").columns("cod") c2=s.tables("gr243").columns("sectia") leg=new DataRelation("leg1",c1,c2) s.relations.add(leg) Plecând de la o înregistrare din tabelul părinte se pot determina înregistrările corespunzătoare din tabelul fiu prin metoda GetChildRows(obiectDatatRelation) As DataRow(). Exemplu de folosire: Dim rp as DataRow,rf as DataRow for each rp in s.tables("sectii").rows... for each rf in rp.getchildrows("legbaieti")... next... Next Intr-o bază de date se doreşte ca datele să fie corecte, adică să îndeplinească anumite restricţii. Intr-un DataSet se pot defini următoarele două tipuri de restricţii: Restricţii de cheie unică (valorile unei coloane sau a unei mulţimi de coloane să fie unice) prin obiecte UniqueConstraint. Această restricţie se asociază tabelului pentru care se defineşte cheia unică. Una dintre cheile unice poate fi aleasă ca şi cheie primară. Restricţia de cheie externă (precizarea unei reguli de actualizare a datelor dintr-un tabel "fiu" atunci când înregistrarea corespunzătoare din tabelul "părinte" este ştearsă sau modificată). Aceste restricţii se gestionează prin obiecte ForeignKeyConstraint şi se asociază tabelului "fiu". La definirea unui obiect DataRelation se adaugă automat următoarele restricţii: Restricţia de cheie unică pentru tabelul "parinte" Restricţia de cheie externă pentru tabelul "fiu" Mulţimea tuturor restricţiilor definite într-un DataTable formează colecţia Constraints. Pentru această colecţie există metodele Add, Remove, Clear, şi proprietatea Count. Un obiect DataRow poate să nu fie încă ataşat colecţiei Rows a unui DataTable, sau poate să fie o linie din această colecţie. Un astfel de obiect are o anumită stare, care se poate obţine cu proprietatea RowState: Unchanged - linia nu a fost schimbată Added - linia este nouă (a fost adăugată) Deleted - linia a fost marcată pentru ştergere Modified - linia a fost modificată Detached - linia nu aparţine unei colecţii Rows Dacă operaţiile de adăugare şi ştergere se precizează uşor prin apelul unei metode, pentru editare pot apare mai multe instrucţiuni. Inceputul operaţiilor de editare (şi trecerea liniei în starea "edit") se face prin metoda BeginEdit(). La sfârşitul operaţiilor de editare este necesară o metodă prin care se precizează că se termină editarea: EndEdit(), sau se anulează toate atribuirile făcute: CancelEdit(). Intre aceste apeluri de metode se anulează toate evenimentele care eventual apar la schimbarea unor valori, de exemplu verificarea restricţiilor de integritate. Modificările asupra liniilor se pot efectua fără includerea lor între metodele amintite mai sus, dar atunci evenimentele amintite se generează.

9 Pentru a se putea efectua aceste operaţii, un obiect DataRow trebuie să păstreze mai multe valori (versiuni ale datelor). Versiunile posibile se pot specifica printr-o valoare din colecţia de valori DataRowVersion: Original - valoarea iniţială a liniei, care nu există pentru starea Added Current - valoarea curentă a liniei, care nu există pentru starea Deleted Proposed - pentru liniile ne-incluse într-o colecţie Rows, sau în timpul editării (după BeginEdit şi înainte de EndEdit/CancelEdit) Default - care este una din valorile Original (pentru starea Deleted), Current (pentru una din stările Added, Modified, Unchanged), sau Proposed (pentru starea Detached) Cu metoda HasVersion(tip_versiune) as boolean - se poate determina dacă o linie are o anumită versiune sau nu. Valoarea versiunii dorite (dacă există) se poate determina astfel: obiectdatarow(nume_coloana, DataRowVersion.tip) obiectdatarow(index_coloana, DataRowVersion.tip) obiectdatarow(obiectdatarow, DataRowVersion.tip) O linie dintr-un DataTable poate să fie modificată (printr-un şir de atribuiri), adăugată, ştearsă. Aceste modificări care se fac pot să fie: păstrate în DataTable, situaţie care se precizează cu metoda AcceptChanges. Dacă există un apel BeginEdit care nu s-a încheiat cu EndEdit/CancelEdit, atunci se apelează implicit un EndEdit. anulate, care se precizează cu metoda RejectChanges. Dacă există un apel BeginEdit care nu s-a încheiat cu EndEdit/CancelEdit, atunci se apelează implicit un CancelEdit. Aseste două metode pot să fie folosite pentru o linie (obiect datarow), un obiect DataTable, sau un obiect DataSet şi se aplică la obiectul DataRow, la toate obiectele DataRow din obiectul DataTable, sau la toate liniile din toate tabelele incluse în DataSet. Efectul acestor două metode asupra versiunii şi stării unei linii este: AcceptChanges schimbă starea liniilor la Unchanged, liniile cu starea Deleted sunt eliminate, versiunea Original se schimbă cu Current RejectChanges schimbă starea liniilor la Unchanged, liniile cu starea Added sunt eliminate, versiunea Current se schimbă cu Original Obiecele DataSet şi DataTable au şi metoda GetChanges([stareInregistrare]) care crează un nou obiect de acelaşi tip (DataSet sau DataTable) ce conţine taoate înregistările modificate sau numai cele care s-au modificat într-un anumit mod (valoare a argumentului, DataRowState), de la crearea obiectului sau de la ultimul apel a metodei AcceptChanges.. Inregistrările incluse într-un DataTable depind de instrucţiunea Select care le-a generat şi care precizează starea iniţială a obiectului. La obiect se pot adăuga linii, se pot şterge linii, sau se pot modifica valorile unor coloane din anumite linii, rezultând în fiecare moment o stare curentă a obiectului DataTable. In aplicaţii aceleaşi obiect DataTable trebuie parcurs în diferite feluri, iar întro astfel de operaţie liniile ar trebui sortate după diferite criterii şi eventual să se folosească diferite condiţii de filtrare pentru linii. O astfel de parcurgere se poate realiza astfel: Prin folosirea colecţiei Rows, care este o colecţie de obiecte DataRow Prin folosirea metodei DataTable.Select([Conditie_filtrare[, Criteriu_sortare[, RowStateFilter]]]), Cu obiecte DataView. Un astfel de obiect se poate crea prin constructorul clasei plecând de la un obiect DataTable, în felul următor New DataView (DataTable[, Conditie_filtrare[, Criteriu_sortare[, RowStateFilter]]]), unde: Conditie_filtrare este de tipul: "nume_coloana operator valoare" Criteriu_sortare este o lista de elemente de forma: nume_coloana [ASC DESC], cu ASC implicit

10 RowStateFilter (atât la metoda Select de la DataTable, cât şi de la crearea obiectului DataView) precizează datele care vor fi incluse în obiect (după filtrare şi sortare) şi este o constantă obţinută prin operaţii cu or pe biţi asupra următoarelor valori: Valoarea Descriere Val. echivalenta DataViewRowState.Added Liniile adăugate 4 DataViewRowState.CurrentRows Liniile curente din DataTable (nemodificate, 22 noi, modificate) DataViewRowState.Deleted Liniile şterse 8 DataViewRowState.ModifiedCurrent Liniile modificate, dar cu valorile curente 16 DataViewRowState.ModifiedOriginal. Liniile modificate, dar cu valorile initiate 32 DataViewRowState.None Nimic 0 DataViewRowState.OriginalRows Liniile originale (inclusiv cele şterse şi 42 modificate) DataViewRowState.Unchanged. Liniile nemodificate 2 Un obiect DataView poate fi considerat ca o colecţie de obiecte de tipul DataRowView. Dintre proprietăţile şi metodele clasei DataView amintim: AllowDelete, AllowEdit, AllowNew - valori booleene ce determină/precizează dacă se pot efectua operaţiile de ştergere, modificare, adăugare în DataView Count - dă numărul de linii din DataView RowFilter - un şir de caractere ce precizează criteriul de filtrare a înregistrărilor RowStateFilter - versiunea curentă a datelor din DataView (corespunzător tabelului de mai sus) Sort - şirul de caractere ce precizează criteriul de sortare Table - obiectul DataTable la care este asociat obiectul DataView AddNew() As DataRowView - permite adaugarea unei linii noi în DataView După ce un obiect DataView a fost creat şi i s-au stabilit proprietăţile, el poate fi folosit pentru Parcurgerea colecţiei de linii pe care le conţine Determinarea înregistrărilor care îndeplinesc o condiţie Efectuarea unor modificări în obiectul DataTable la care este ataşat Căutarea înregistrărilor cu anumite valori pentru coloanele folosite la sortare Exemplu de folosire a metodei Select: 'Parcurgerea cu Select Dim vr as DataRow() vr=ds.tables("tabel1").select("","prenume") for each r in vr... Next Exemplu de folosire a obiectului DataView: 'Crearea unui DataView Dim dv as DataView = New DataView(ds.Tables("tabel1")) 'Parcurgere folosind colectia DataView Dim r as DataRowView Dim i as integer i=0 for each r in dv i=i+1 '... i.tostring+". "+r("nume")+" "+r("prenume")+"") next

11 dv.sort="prenume" dv.rowfilter="nume<'i'" i=0 for each r in dv i=i+1 '... i.tostring+". "+r("nume")+" "+r("prenume")+"") next for i=0 to dv.count-1 '.. ((i+1).tostring+". "+dv(i)("nume")+" "+dv(i)("prenume")+"") next Dacă la un obiect DataView există un criteriu de sortare (proprietatea Sort are cel puţin o coloană), atunci se pot folosi metodele următoare pentru căutarea înregistrărilor ce au anumite valori pentru cheile de sortare. Metoda Sort furnizează indexul primei înregistrări, iar metoda FindRows fornizează o mulţime de înregistrări: Find(Object) as Integer, sau Find(Object()) as Integer Dacă există o singură coloană folosită pentru sortare, atunci metoda dă indexul primei înregistrări cu valoarea argumentului pentru coloana de sortare, sau -1 dacă o astfel de înregistrare nu există. Dacă există mai multe coloane folosite pentru sortare, atunci valorile pentru aceste coloane se vor pune într-un vector, ce va fi trecut ca argument. FindRows(Object) as DataRowsView(), sau FindRows (Object())as DataRowsView(), care furnizează mulţimea tuturor înregistrărilor ce verifică criteriul de căutare. Exemple de folosire a acestor metode: Dim dv as DataView Dim c as DataColumn dv=new DataView(t) dv.sort="grupa" dim n as integer n=dv.find("243") ' dv.sort="nume,prenume" dim a(1) as Object a(0)="pop" a(1)="ioan" n=dv.find(a) ' dv.sort="nume" Dim r as DataRowView for each r in dv.findrows("pop")... Next Un obiect DataView este o colecţie de obiecte de tipul DataRowView. Un obiect DataRowView are şi următoarele proprietăţi: Row - obiectul DataRow corespunzător din DataTable RowVersion - versiunea înregistrării din DataTable folosită BeginEdit, EndEdit, CancelEdit, Delete - cu semnificaţiile de la DataView La folosirea unui obiect DataAdapter pentru crearea unui DataTable (inclus într-un DataSet) se foloseşte un obiect SelectCommand (un obiect Command cu o instrucţiune Select pentru definirea liniilor ce se vor include în DataTable). Fiecare linie din DataTable este un obiect DataRow, iar acest obiect are o anumită stare ce se poate consulta prin proprietatea RowState. Această proprietate poate lua valorile: Added, Deleted, Modified, Unchaged (calificată cu DateRowState.) după cum linia respectivă a fost adaugată, ştearsă, modificată, neschimbată. Obiectul DataAdapter are metoda Update() care examinează starea fiecărei linii şi salvează toate modificările în baza de date. Pentru a se putea face aceste salvări sunt necesare instrucţiuni corespunzătoare stărilor liniilor:

12 Dacă starea este Added, atunci e necesar un obiect InsertCommand pentru obiectul DataAdapter, care este un obiect Command şi o instrucţiune (în mod normal Insert) ce permite adăugarea unei înregistrări în baza de date corespunzătoare liniei adăugate în DataTable Dacă starea este Deleted, atunci e necesar un obiect DeleteCommand pentru precizarea înregistrării din baza de date care se şterge Dacă starea este Modified atunci e necesar un obiect UpdateCommand care specifică o instrucţiune Update ce se va executa la baza de date. Fiecare dintre aceste trei obiecte trebuie să fie configurate, deci să se precizeze proprietăţile: Connecţion, CommandText, CommandType, Properties. Aceste comenzi pot să se refere la mai multe linii (cele modificate, adăugate, şterse) din DataTable, iar pentru o astfel de mulţime de înregistrări se va preciza o singură comandă, deci sunt necesari parametri în aceste comenzi (deci este necesară colecţia Parameters) care pentru o înregistrare curentă să poată genera o comandă de modificare a sursei de date. O valoare ce se foloseşte în comenzile InsertCommand, DeleteCommand, sau UpdateCommand se referă la o linie curentă şi se va preciza cu un parametru (@nume, :nume,? - în funcţie de tipul comenzii DataAdapter), iar pentru fiecare parametru sunt necesare proprietăţile următoare (unele explicate la colecţia Parameters s-au dat la descrierea obiectelor Command): ParameterName, DBType, Precision, Scale, Size, Direction, SourceColumn - numele coloanei sursă a valorii parametrului SourceVersion - versiunea valorii (calificata cu DataRowVersion)care se ia pentru parametru (o coloană are mai multe "versiuni" pentru valoare) Value - o valoare explicită pentru parametru, care are prioritate faţă de SourceColumn Dacă obiectele InsertCommand, DeleteCommand, UpdateCommand nu există la DataAdapter, atunci se generează o execepţie. In anumite cazuri particulare de instrucţiuni Select în SelectCommand se pot genera instrucţiuni de modificare (pentru obiectele InsertCommand, DeleteCommand, UpdateCommand) cu ajutorul obiectelor CommandBuilder. Astfel de instrucţiuni se pot genera automat dacă instrucţiunea Select, ce precizează înregistrările din DataTable, foloseşte un singur tabel din baza de date şi există cel puţin o coloană care este cheie primară sau cheie unică în acest tabel sursă de date (deci pentru o înregistrare selectată în DataTable există o singură înregistrare în tabelul sursă din baza de date şi care se poate determina prin valoarea unei astfel de chei).

13 Tabelul 1. Clasele ADO.NET Class Description SQLConnection OleDbConnection OracleConnection ODBCConnection SQLCommand OleDbCommand OracleCommand ODBCCommand SQLDataReader OleDbDataReader OracleDataReader ODBCDataReader Use a Connection object to create a connection to a data source. You can open a connection to a data source and keep this connection object open for as long as you need it. Use a Command object to submit SQL statements to a back-end data source. You can use SQL or calls to stored procedures for all data retrieval and modification. You can use the ExecuteReader method to return a DataReader object, ExecuteNonQuery to run an update/delete/insert query, or ExecuteScalar to return a single value as the result of the SQL you've provided. The DataReader class provides a forward-only, read-only cursor (sometimes called a fire hose cursor) that reads data from a data source in the most efficient manner available to ADO.NET. This class is excellent for filling DataGrids, list boxes, and combo boxes. Under the covers, the DataAdapter object uses a DataReader to fill the contents of a DataSet. SQLDataAdapter The DataAdapter object provides four Command object properties: one each for OleDbDataAdapter a Select, Update, Insert, and Delete command. You'll use a DataAdapter OracleDataAdapter object's Fill method (and its SelectCommand property) to populate a DataSet or ODBCDataAdaptera DataTable object with data from a database. You can use the Update method of the DataAdapter to save changes you've made to a DataSet back to the original data source(s), and the DataAdapter will determine, based on the changes you've made, which of its commands (Update, Insert, or Delete) to use. DataSet DataTable DataRelation DataView DataSet objects can contain one or more DataTable objects, much like an in memory database. You have the ability to set relationships between these DataTable objects. You can modify the data in a DataSet, and DataSet objects can hold both the original set of data and any modifications made to this data. You can then use other ADO.NET objects to submit these changes back to the data source. This class does not provide any means to communicate directly with any type of data source that functionality is provided by the DataAdapter objects. DataTable objects hold rows of data. Each row is made up of columns, and each column can hold some discreet data. The DataTable object provides a collection of DataRow objects and a collection of DataColumn objects. Each DataRow object contains the data stored within a single row in the DataTable, and DataColumn objects provide information about the schema of the DataTable. Like the DataSet object, DataTable objects have no means to communicate with any type of data source. You can add data to the DataTable object programmatically, one row at a time, or you can use the Fill method of a DataAdapter object to fill a DataTable with data from a data source. Represents a parent/child relationship between two DataTable objects. Instances of this class provide a specific view of a DataTable. This object is frequently used to set sort orders or filters on a DataTable object.

14 SQLCommandBuilder When you work with a DataAdapter object, you'll need to provide Insert, OleDbCommandBuilder Update, and Delete commands, in addition to a Select command, if you want OracleCommandBuilder to modify data. Although you can supply the SQL expressions yourself, it ODBCCommandBuilder would be easier if someone else could do the work. That's the job of the CommandBuilder object, which can generate Insert, Update, and Delete commands based on the Select command you supply. A DataAdapter can then use these commands to update the original data source(s). (You should note that the CommandBuilder does build commands for you, but the SQL it creates won't be optimized and will almost always include more fields than you might need.) Tabelul 2. Spaţiile de nume pentru gestiunea datelor: System.Data - consists of the classes that constitute the ADO.NET architecture, which is the primary data access method for managed applications. The ADO.NET architecture enables you to build components that efficiently manage data from multiple data sources. ADO.NET also provides the tools to request, update, and reconcile data in distributed applications. System.Data.Common - contains classes shared by the.net Framework data providers. Data providers describe a collection of classes used to access a data source, such as a database, in the managed space. System.Xml - classes that provide standards-based support for processing XML. System.Data.OleDb classes that make up the.net Framework Data Provider for OLE DB-compatible data sources. These classes allow you to connect to an OLE DB data source, execute commands against the source, and read the results. System.Data.SqlClient classes that make up the.net Framework Data Provider for SQL Server, which allows you to connect to SQL Server 7.0, execute commands, and read results. The System.Data.SqlClient namespace is similar to the System.Data.OleDb namespace, but is optimized for access to SQL Server 7.0 and later. System.Data.SqlTypes - Provides classes for native data types within SQL Server. These classes provide a safer, faster alternative to other data types. System.Data.Odbc - classes that make up the.net Framework Data Provider for ODBC. These classes allow you to access ODBC data source in the managed space. System.Data.OracleClient - classes that make up the.net Framework Data Provider for Oracle. These classes allow you to access an Oracle data source in the managed space.