Dodatek C
Obiekty ADO.NET: Właściwości i metody

ADO.NET składa się z dwóch podstawowych części — klasy DataSet wraz z innymi klasami związanymi z nią oraz z zarządzanych dostawców danych, którzy ułatwiają komunikację ze źródłami danych. W niniejszym dodatku zostaną opisane wszystkie klasy należące do obu części ADO.NET.

Klasa DataSet i klasy z nią związane

W tej części rozdziału zostaną podane szczegółowe informacje na temat klasy DataSet oraz klas bezpośrednio z nią związanych, takich jak DataRelation, DataTable i tak dalej.

Klasa DataSet służy do przechowywania danych w pamięci i udostępnia spójne możliwości programowej obsługi tych danych niezależnie od ich typu. Obiekty tej klasy zawierają kompletny zbiór danych, włącznie z narzucanymi na nie ograniczeniami, wzajemnymi relacjami, a nawet wieloma, wykorzystywanymi jednocześnie tabelami. Ogólny schemat modelu danych dostarczanego przez klasę DataSet został przedstawiony na rysunku C.1.

Rysunek C.1. Model klasy DataSet

Klasy Constraint oraz ConstraintCollection

Obiekty klasy Constraint reprezentują reguły narzucane na tabelę i ograniczające informacje jakie mogą zostać zmodyfikowane. Właściwości tej klasy zostały przedstawione w tabeli C.1.

Tabela C.1. Właściwości klasy Constraint.

Właściwość	Opis
ConstraintName	Nazwa danego ograniczenia.
Table	Właściwość zwraca obiekt DataTable którego dotyczy ograniczenie.

W tabeli C.2 zostały przedstawione wszystkie właściwości, metody oraz zdarzenia klasy ConstraintCollection.

Właściwość	Opis
Item	Właściwość zwraca ograniczenie (obiekt klasy Constraint) zapisane w kolekcji, określając je na podstawie podanej nazwy bądź indeksu.
Metoda	Opis
Add	Dodaje ograniczenie do kolekcji. Metoda ta jest przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
CanRemove (ograniczenie)	Określa czy ograniczenie podane jako argument wywołania metody może zostać usunięte z obiektu klasy DataTable.
Clear	Usuwa z kolekcji wszystkie obiekty Constraint.
Contains (nazwa)	Sprawdza czy w kolekcji znajduje się obiekt Constraint o podanej nazwie.
IndexOf	Zwraca indeks podanego ograniczenia. Ta metoda jest przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
Remove	Usuwa wskazane ograniczenie z kolekcji. Ta metoda jest przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
RemoveAt	Usuwa z kolekcji obiekt Constraint o podanym indeksie.
Zdarzenie	Opis
CollectionChanged	Zdarzenie to zachodzi gdy w wyniku dodania lub usunięcia elementu zmienia się zawartość kolekcji. Argumentem przekazywanych w wywołaniu procedury obsługi tego zdarzenia jest obiekt klasy CollectionChangeEventArgs. Klasa ta udostępnia następujące właściwości: Action — Właściwość może zwracać wartości (Add, Remove, Refresh) określające wykonaną czynność. Element — Zwraca kopię kolekcji, która została zmieniona.

Klasy DataColumn oraz DataColumnCollection

Klasa DataColumn reprezentuje kolekcję informacji przechowywanych w obiektach DataTable. Właściwości, metody oraz zdarzenia tej klasy zostały przedstawione w tabeli C.3.

Tabela C.3. Właściwości, metody oraz zdarzenia klasy DataColumn.

Właściwość	Opis
AllowDBNull	Właściwość określa czy w tej kolumnie mogą być zapisywane wartości null.
AutoIncrement	Określa czy wartości w tej kolumnie są automatycznie inkrementowane w momencie dodawania nowego wiersza.
AutoIncrementSeed	Wartość początkowa dla automatycznej inkrementacji pól kolumny.
AutoIncrementStep	Wartość używana do inkrementacji wartości pól tej kolumny.
Caption	Tytuł kolumny.
ColumnMapping	Zwraca obiekt klasy MappingType określający w jaki sposób kolumna będzie odwzorowywana w przypadku zapisu danych w formacie XML.
ColumnName	Nazwa kolumny.
DataType	Typ danych przechowywanych w kolumnie.
DefaultValue	Domyślna wartość zapisywana w polach tej kolumny w czasie tworze nowych wierszy.
Expression	Wyrażenie używane do filtrowania wierszy, obliczania wartości pól lub tworzenia kolumn zagregowanych, zapisane w formie łańcucha znaków.
ExtendedProperties	Zwraca obiekt klasy PropertyCollection zawierający informacje podane przez użytkownika.
Namespace	Przestrzeń nazw XML zawierająca elementy wykorzystywane w tej kolumnie.
Ordinal	Położenie tej kolumny w obiekcie DataColumnCollection.
Prefix	Prefiks którym poprzedzana jest nazwa kolumny w przypadku zapisywania danych w formacie XML.
ReadOnly	Określa czy w danej kolumnie można wprowadzać jakiekolwiek modyfikacje.
Table	Zwraca obiekt klasy DataTable do którego należy dana kolumna.
Unique	Określa czy wartości zapisywane w poszczególnych polach tej kolumny muszą być unikalne.
Metoda	Opis
ToString	Zwraca obiekt klasy Expression dla danej kolumny (jeśli istnieje), --> a w przeciwnym przypadku nazwę kolumny.[Author:p8R]
Zdarzenie	Opis
PropertyChanged	Zdarzenie jest generowane w razie modyfikacji którejś z właściwości kolumny. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy PropertyChangedEventArgs, zawierający następującą właściwość: PropertyName — Nazwa właściwości która uległa zmianie.

W tabeli C.4 zostały przedstawione właściwości, metody oraz zdarzenia klasy DataColumnCollection.

Tabela C.4. Właściwości, metody i zdarzenia klasy DataColumnCollection.

Właściwość	Opis
Item	Pobiera z kolekcji obiekt klasy DataColumn określony za pomocą nazwy kolumny lub indeksu.
Metoda	Opis
Add	Dodaje kolumnę do kolekcji. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
AddRange	Dodaje do kolekcji tablicę obiektów DataColumn.
CanRemove (kolumna)	Sprawdza czy kolumna określona przy użyciu argumentu kolumna może zostać usunięta z kolekcji.
Clear	Usuwa z kolekcji wszystkie obiekty DataColumn.
Contains(nazwa)	Określa czy w kolekcji istnieje obiekt DataColumn reprezentujący kolumnę o podanej nazwie.
IndexOf	Określa indeks danej kolumny. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
Remove	Usuwa z kolekcji wskazaną kolumnę. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
RemoveAt	Usuwa z kolekcji kolumnę o podanym indeksie.
Zdarzenie	Opis
CollectionChanged	Zdarzenie to zachodzi gdy w wyniku dodania lub usunięcia elementu zmienia się zawartość kolekcji. Argumentem przekazywanych w wywołaniu procedury obsługi tego zdarzenia, jest obiekt klasy CollectionChangeEventArgs. Klasa ta udostępnia następujące właściwości: Action — Właściwość może zwracać wartości (Add, Remove, Refresh) określające wykonaną czynność. Element — Zwraca kopię kolekcji, która została zmieniona.

Klasy DataRelation oraz DataRelationCollection

Obiekty klasy DataRelation reprezentują wzajemne relacje występujące pomiędzy tabelami przechowywanymi w obiekcie DataSet. Właściwości i zdarzenia tej klasy zostały przedstawione w tabeli C.5.

Tabela C.5. Właściwości i metody klasy DataRelation.

Właściwość	Opis
ChildColumns	Zwraca tablicę obiektów klasy DataColumn reprezentujących kolumny podrzędne danej relacji.
ChildKeyConstraint	Obiekt klasy ForeignKeyConstraint dla danej relacji.
ChildTable	Zwraca obiekt klasy DataTable reprezentujący tabelę podrzędną danej relacji.
DataSet	Zwraca obiekt DataSet do którego należy dana relacja.
ExtendedProperties	Zwraca obiekt PropertyCollection zawierający informacje podane przez użytkownika.
Nested	Określa czy relacja jest zagnieżdżona.
ParentColumns	Zwraca obiekt klasy DataColumn reprezentujący nadrzędną kolumnę danej relacji.
ParentKeyConstraint	Obiekt klasy UniqueConstraint dla danej relacji.
ParentTable	Zwraca obiekt klasy DataTable reprezentujący nadrzędna tabelę danej relacji.
RelationName	Nazwa relacji.
Zdarzenie	Opis
PropertyChanged	Zdarzenie jest generowane w razie modyfikacji którejś z właściwości relacji. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy PropertyChangedEventArgs, zawierający następującą właściwość: PropertyName — Nazwa właściwości która uległa zmianie.

Tabela C.6 zawiera właściwości, metody oraz zdarzenia klasy DataRelationCollection.

Tabela C.6. Właściwości, metody oraz zdarzenia klasy DataRelationCollection.

Właściwość	Opis
Item	Pobiera z kolekcji obiekt DataRelation na podstawie podanej nazwy relacji lub jej indeksu.
Metoda	Opis
Add	Dodaje relację do kolekcji. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
AddRange	Dodaje do kolekcji tablicę z obiektami DataRelation.
Clear	Usuwa z kolekcji wszystkie obiekty DataRelation.
Contains(nazwa)	Określa czy obiekt DataRelation reprezentujący relację o podanej nazwie istnieje w kolekcji.
Remove	Usuwa wskazaną relację z kolekcji. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
RemoveAt	Usuwa z kolekcji relację (obiekt DataRelation) o podanym indeksie.
Zdarzenie	Opis
CollectionChanged	Zdarzenie to zachodzi gdy w wyniku dodania lub usunięcia elementu zmienia się zawartość kolekcji. Argumentem przekazywanych w wywołaniu procedury obsługi tego zdarzenia, jest obiekt klasy CollectionChangeEventArgs. Klasa ta udostępnia następujące właściwości: Action — Właściwość może zwracać wartości (Add, Remove, Refresh) określające wykonaną czynność. Element — Zwraca kopię kolekcji, która została zmieniona.

Klasy DataRow oraz DataRowCollection

Obiekty klasy DataRow reprezentują wiersze informacji przechowywane w obiektach DataTable — czyli poszczególne rekordy danych. Właściwości i metody tej klasy zostały przedstawione w tabeli C.7.

Tabela C.7. Właściwości i metody klasy DataRow.

Właściwość	Opis
HasErrors	Właściwość określa czy w danych zapisanych w tym wierszu występują jakieś błędy.
Item	Zwraca daną przechowywaną we wskazanej kolumnie. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
ItemArray	Zwraca tablicę zawierającą wszystkie dane przechowywane w danym wierszu.
RowError	Opis błędu występującego w danym wierszu.
RowState	Właściwość określa stan wiersza. Może przyjmować następujące wartości: Detached, Unchanged, New, Deleted oraz Modified.
Table	Zwraca obiekt klasy DataTable do którego należy dany wiersz.
Metoda	Opis
AcceptChanges	Zatwierdza wszelkie modyfikacje wprowadzone w danym wierszu.
BeginEdit	Rozpoczyna operację edycji danego wiersza.
CancelEdit	Przerywa operację edycji i odrzuca wszelkie wprowadzone modyfikacje.
ClearErrors	Usuwa wszystkie błędy występujące w danym wierszu.
Delete	Usuwa wiersz.
EndEdit	Zakańcza operację edycji danego wiersza.
GetChildRows	Zwraca tablicę obiektów DataRow reprezentujących wiersze podrzędne w stosunku do danego wiersza, w przypadku zastosowania podanego obiektu DataRelation.
GetColumnError	Zwraca błąd występujący w podanej kolumnie wiersza. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
GetColumnsInError	Zwraca tablicę obiektów DataColumn reprezentujących kolumny w których występują błędy.
GetParentRow	Zwraca obiekt DataRow reprezentujący wiersz nadrzędny w stosunku do danego. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
GetParentRows	Zwraca tablicę zawierającą wiersze nadrzędne w stosunku do danego, w przypadku wykorzystania podanego obiektu DataRelation. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
HasVersion (wersja)	Określa czy istnieje podana wersja danego wiersza.
IsNull	Określa czy podana kolumna wiersza zawiera wartość null. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
IsUnspecified	Określa czy wartość wskazanej kolumny nie została określona. Metoda przeciążona.
RejectChanges	Odtwarza wszelkie modyfikacje wprowadzone w wierszu.
SetColumnError	Podaje opis błędu dla danej kolumny. Metoda przeciążona.
SetParentRow	Podaje wiersz nadrzędny dla danego wiersza podrzędnego. Metoda przeciążona.
SetUnspecified	Określa, że wartość wskazanej kolumny danego wiersza ma być nieokreślona. Metoda przeciążona.

W tabeli C.8 zostały przedstawione właściwości i metody klasy DataRowCollection.

Tabela C.8. Właściwości i metody klasy DataRowCollection.

Właściwość	Opis
Item	Zwraca z kolekcji obiekt DataRow reprezentujący wiersz o określonej nazwie lub indeksie.
Metoda	Opis
Add	Dodaje wiersz do kolekcji. Metoda przeciążona.
Clear	Usuwa z kolekcji wszystkie obiekty klasy DataRow.
Contains(nazwa)	Określa czy obiekt DataRow o podanej nazwie istnieje w kolekcji.
Find	Zwraca określony obiekt DataRow. Metoda przeciążona.
Remove	Usuwa z kolekcji określony obiekt DataRow. Metoda przeciążona.
RemoveAt	Usuwa z kolekcji obiekt DataRow o określonym indeksie.

Klasa DataSet

Właściwości, metody oraz zdarzenia tej klasy zostały opisane w tabeli C.9.

Tabela C.9. Właściwości, metody oraz zdarzenia klasy DataSet.

Właściwość	Opis
CaseSensitive	Właściwość określa czy przy porównywaniu łańcuchów znaków w tym obiekcie DataSet będzie uwzględniana wielkość liter.
DataSetName	Nazwa danego obiektu DataSet.
DefaultViewManager	Zwraca obiekt klasy DataViewManager zawierający informacje o zmodyfikowanym sposobie prezentacji danego obiektu DataSet.
EnforceConstraints	Właściwość określa czy przy aktualizacji danych mają być wymuszane reguły.
ExtendedProperties	Obiekt PropertyCollection zawierający informacje określane przez użytkownika.
HasErrors	Informuje czy dane zapisane w którymkolwiek z wierszy przechowywanych w danym obiekcie DataSet zawierają błędy.
Locale	Informacje lokalne używane przy porównywaniu łańcuchów znaków. Właściwość ta zwraca obiekt klasy CultureInfo.
Prefix	Synonim XML określający przestrzeń nazw danego obiektu DataSet.
Relations	Obiekt klasy DataRelationCollection reprezentujący wszystkie relacje występujące pomiędzy tabelami przechowywanym w danym obiekcie DataSet.
Site	Zwraca interfejs ISite do obiektu klasy DataSet (służący do wiązania komponentów z obiektami zawierającymi dane).
Tables	Obiekt klasy DataTableCollection reprezentujący wszystkie tabele przechowywane w danym obiekcie DataSet.
Xml	Dane przechowywane w danym obiekcie DataSet, zapisane w formacie XML.
XmlSchema	Schemat XML wykorzystywany w danym obiekcie DataSet.
Metoda	Opis
AcceptChanges	Zatwierdza wszelkie modyfikacje wprowadzone w danym obiekcie DataSet.
BeginInit	Rozpoczyna inicjalizację obiektu DataSet w trakcie działania programu.
Clear	Usuwa wszystkie wiersze ze wszystkich tabel zapisanych w danym obiekcie DataSet.
Clone	Tworzy obiekt DataSet stanowiący dokładną kopię danego obiektu, lecz bez danych.
Copy	Tworzy obiekt DataSet stanowiący dokładną kopię danego obiektu i zawierający wszystkie dane.
EndInit	Zakańcza proces inicjalizacji obiektu DataSet w trakcie działania programu.
GetChanges	Tworzy nowy obiekt klasy DataSet zawierający wyłącznie dane, które zostały zmodyfikowane.
HasChanges	Określa czy informacje w danym obiekcie DataSet uległy jakimkolwiek zmianom.
InferXmlSchema	Tworzy strukturę danych na podstawie źródła danych XML. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
Marge(DataSet)	Łączy dany obiekt DataSet z obiektem podanym jako argument wywołania metody.
ReadXmlSchema	Tworzy strukturę danych na podstawie schematu XML. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
RejectChanges	Odtwarza wszelkie zmiany jakie zostały wprowadzone w obiekcie DataSet.
ResetRelations	Przywraca domyślną wartość właściwości Relations.
ResetTables	Przywraca domyślną wartość właściwości Tables.
ShouldSerializeRelations	Informuje czy wartość właściwości Relations powinna zostać zachowana.
ShouldSerializeTables	Informuje czy wartość właściwości Tables powinna zostać zachowana.
WriteXml	Zapisuje zawartość obiektu DataSet w formacie XML. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
WriteXmlSchema	Zapisuje strukturę obiektu DataSet w formacie XML. Metoda przeciążona, więcej informacji na jej temat można znaleźć w dokumentacji .NET SDK.
Zdarzenie	Opis
MergeFailed	Zdarzenie jest generowane gdy zarówno źródłowy jak i docelowy obiekt DataSet będzie miał tę samą wartość klucza głównego, a jednocześnie właściwość EnforceConstraints będzie miała wartość true.
PropertyChanged	Zdarzenie jest generowane w razie modyfikacji którejś z właściwości kolumny. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy PropertyChangedEventArgs, zawierający następującą właściwość: PropertyName — Nazwa właściwości która uległa zmianie.

Klasy DataTable oraz DataTableCollection

Obiekty klasy DataTable reprezentują tabele danych, przechowywane w obiektach DataSet; właściwości, metody oraz zdarzenia tej klasy zostały przedstawione w tabeli C.10.

Tabela C.10. Właściwości, metody i zdarzenia klasy DataTable.

Właściwość	Opis
CaseSensitive	Określa czy przy porównywaniu łańcuchów znaków w danej tabeli ma być uwzględniana wielkość liter.
ChildRelations	Zwraca obiekt klasy DataRelationCollection zawierający relacje podrzędne dla danej tabeli.
Columns	Zwraca obiekt kasy DataColumnCollection reprezentujący kolumny danej tabeli.
Constraints	Zwraca obiekt --> klasy ConstraintCollection reprezentujący wszystkie reguły obowiązujące dane przechowywane w tej tabeli.[Author:p8R]
DataSet	Zwraca obiekt DataSet do którego należy dana tabela.
DefaultView	Zwraca obiekt DataView reprezentujący zmodyfikowany sposób prezentacji danych przechowywanych w danej tabeli.
DisplayExpression	Wyrażenie łańcuchowe określające w jaki sposób dana tabela ma być wyświetlana w elementach sterujących interfejsu użytkownika.
ExtendedProperties	Zwraca obiekt klasy PropertyCollection zawierający informacje podane przez użytkownika.
HasErrors	Właściwość informuje czy w którymkolwiek z wierszy tej tabeli występują jakiekolwiek błędy.
Locale	Obiekt klasy CultureInfo używany do określania sposobu porównywania łańcuchów znaków.
MinimumCapacity	Początkowa wielkość danego tabeli.
Namespace	Przestrzeń nazw XML zawierająca elementy stosowane w danej tabeli.
ParentRelations	Obiekt klasy DataRelationCollection zawierający nadrzędne relacje dla danej tabeli.
Prefix	Prefiks wykorzystywany podczas zapisywania danej tabeli w formacie XML.
PrimaryKey	Tablica obiektów DataColumn reprezentujących kolumny spełniające funkcję klucza głównego tabeli.
Rows	Obiekt klasy DataRowCollection reprezentujący wszystkie wiersze należące do danej tabeli.
Site	Zwraca interfejs ISite do obiektu DataTable (służący do wiązania komponentów z obiektami zawierającymi dane).
TableName	Nazwa tabeli.
Metoda	Opis
AcceptChanges	Zatwierdza wszelkie modyfikacje wprowadzone w danej tabeli.
BeginInit	Rozpoczyna proces inicjalizacji tabeli.
BeginLoadData	Rozpoczyna proces pobierania danych i zapisywania ich w tabeli.
Clear	Usuwa wszystkie dane przechowywane w tabeli.
Compute(wyr, filtr)	Oblicza wartość wyrażenia określonego jako argument wyr, w wierszach które spełniają kryterium określone jako argument filtr.
EndInit	Kończy proces inicjalizacji tabeli.
EndLoadData	Kończy proces pobierania danych.
GetErrors	Tablica obiektów klasy DataRow, w których występują błędy.
LoadDataRow(wartosci(), akceptuj)	Wypełnia i aktualizuje obiekt DataRow wartościami przekazanymi w tablicy wartosci. Drugi argument wywołania metody określa czy aktualizacja powinna zostać zatwierdzona. Jeśli nie zostanie odnaleziony żaden wiersza, metoda utworzy nowy.
NewRow	Zwraca pusty obiekt DataRow utworzony na bazie tego samego schematu co cała tabela.
RejectChanges	Odtwarza wszelkie modyfikacje wprowadzone w tabeli.
ResetColumns	Przywraca domyślną wartość właściwości Columns.
ResetConstraints	Przywraca domyślną wartość właściwości Constraints.
ResetPrimaryKey	Przywraca domyślną wartość właściwości PrimaryKey.
Select	Zwraca tablicę obiektów DataRow. Metoda jest przeciążona.
ShouldSerializeColumns	Określa czy należy zachować wartość właściwości Columns.
ShouldSerializeConstraints	Określa czy należy zachować wartość właściwości Constraints.
ShouldSerializePrimaryKey	Określa czy należy zachować wartość właściwości PrimaryKey.
ToString	Zwraca wartość właściwości TableName oraz DisplayExpression dla danej tabeli.
Zdarzenia	Opis
ColumnChanged	Zdarzenie jest generowane w razie modyfikacji którejś z kolumn. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataColumnChangedEventArgs, zawierający następujące właściwość: Column — Modyfikowana kolumna. ProposedValue — Wartość jaka ma zostać przypisana danemu polu tabeli. Row — Modyfikowany wiersz tabeli.
ColumnChanging	Zdarzenie zachodzi po wprowadzeniu zmian w tabeli. Procedura obsługi tego zdarzenia wykorzystuje obiekt klasy DataColumnChangedEventArgs.
PropertyChanged	Zdarzenie jest generowane w razie modyfikacji którejś z właściwości tabeli. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy PropertyChangedEventArgs, zawierający następującą właściwość: PropertyName — Nazwa właściwości która uległa zmianie.
RowChanged	Zdarzenie jest generowane w razie zmiany zawartości wiersza. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataRowChangedEventArgs, zawierający następujące właściwość: Action — Określa czynność jaka została wykonana na danym obiekcie DataRow. Row — Określa obiekt DataRow, który należy zmienić.
RowChanging	Zdarzenie to jest generowane po wprowadzeniu zmian w danym wierszu. W procedurze obsługi tego zdarzenia wykorzystywany jest obiekt klasy DataRowChangedEventArgs.
RowDeleted	Zdarzenie to jest generowane po usunięciu wiersza. W procedurze obsługi tego zdarzenia wykorzystywany jest obiekt klasy DataRowChangedEventArgs.
RowDeleting	Zdarzenie to jest generowane przed usunięciem wiersza. W procedurze obsługi tego zdarzenia wykorzystywany jest obiekt klasy DataRowChangedEventArgs.

W Tabeli C.11 zostały przedstawione właściwości, metody oraz zdarzenia klasy DataTableCollection.

Tabela C.11. Właściwości, metody i zdarzenia klasy DataTableCollection.

Właściwość	Opis
Item	Pobiera obiekt DataTable z kolekcji na podstawie nazwy tabeli lub jej indeksu.
Metoda	Opis
Add	Dodaje tabelę do kolekcji. Metoda przeciążona.
AddRange	Dodaje do kolekcji tablicę obiektów DataTable.
CanRemove(tabela)	Określa czy z kolekcji można usunąć obiekt DataTable reprezentujący wskazaną tablicę.
Clear	Usuwa z kolekcji wszystkie obiekty DataTable.
Contains(nazwa)	Sprawdza czy obiekt DataTable reprezentujący tablicę o podanej nazwie istnieje w kolekcji.
IndexOf	Zwraca indeks określonej tabeli. Metoda przeciążona.
Remove	Usuwa z kolekcji wskazaną tabelę. Metoda przeciążona.
RemoveAt	Usuwa z kolekcji obiekt DataTable o określonym indeksie.
Zdarzenia
CollectionChanged	Zdarzenie to zachodzi gdy w wyniku dodania lub usunięcia elementu zmienia się zawartość kolekcji. Argumentem przekazywanych w wywołaniu procedury obsługi tego zdarzenia, jest obiekt klasy CollectionChangeEventArgs. Klasa ta udostępnia następujące właściwości: Action — Właściwość może zwracać wartości (Add, Remove, Refresh) określające wykonaną czynność. Element — Zwraca kopię kolekcji, która została zmieniona.
CollectionChanging	Zdarzenie to jest zgłaszane przed wprowadzenie zmian w kolekcji. W procedurze jego obsługi wykorzystywany jest obiekt klasy CollectionChangeEventArgs.

Klasa DataView

Obiekty tej klasy reprezentują dostosowane do własnych potrzeb sposoby prezentacji danych przechowywanych w obiektach DataSet. Właściwości, metody oraz zdarzenia dostępne w tej klasie zostały przedstawione w tabeli C.12.

Tabela C.12. Właściwości, metody oraz zdarzenia klasy DataView.

Właściwość	Opis
AllowDelete	Określa czy w danym widoku można usuwać dane.
AllowEdit	Określa czy w danym widoku można edytować dane.
AllowNew	Określa czy w danym widoku można dodawać nowe wiersze.
ApplyDefaultSort	Określa czy należy użyć domyślnego sposobu sortowania.
DataViewManager	Obiekt DataView, który utworzył dany widok (wskaźnik do obiektu DataSetView który posiada wykorzystywany obiekt DataSet).
Item(indeks)	Zwraca wskazany wiersz tabeli.
RowFilter	Wyrażenie służące do określania które wiersze zostaną dodane do obiektu DataView.
RowStateFilter	Określa które wersje rekordów będą dodawane do obiektu DataView. Właściwość ta może przybierać wartości None, Unchanged, New, Deleted, ModifiedCurrent, ModifiedOriginal, OriginalRows oraz CurrentRows (wartość domyślna).
Sort	Kolumna na podstawie której dane będą sortowane.
Table	Źródłowy obiekt DataTable z którego będą pobierane dane.
Metoda	Opis
AddNew	Dodaje nowy wiersz do obiektu DataView.
BeginInit	Rozpoczyna inicjalizację danego obiektu DataView.
Delete(indeks)	Usuwa wiersz o podanym indeksie.
Dispose	Niszczy bieżącą kopię obiektu i zwalnia wszystkie zasoby, których ten obiekt używał.
EndInit	Kończy proces inicjalizacji obiektu.
Find	Odnajduje konkretny wiersz w obiekcie DataView. Metoda przeciążona.
GetEnumerator	Zwraca interfejs IEnumerator którego można użyć do pobierania kolejnych wierszy znajdujących się w danym obiekcie DataView.
Zdarzenie	Opis
ListChanged	Zdarzenie zachodzi gdy lista zarządzana przez obiekt DataView ulegnie zmianie. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy ListChangedEventArgs. Klasa ta zawiera następujące właściwości: ListChangedType — Określa typ zmian wprowadzonych w liście. NewIndex — Nowy indeks zmienionego elementu listy. OldIndex — Poprzedni indeks zmienionego elementu listy.
PropertyChanged	Zdarzenie jest generowane w razie zmiany wartości którejś z właściwości. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy PropertyChangedEventArgs, zawierający następującą właściwość: PropertyName — Nazwa właściwości która uległa zmianie.

Zarządzani dostawcy danych

Zarządzani dostawcy danych pozwalają ADO.NET na interakcję z dowolnymi typami źródeł danych zgodnymi z OleDb. Dostawcy ci służą do przenoszenia danych z bazy danych do obiektów DataSet oraz innych skojarzonych z nimi obiektów; można ich także używać niezależnie do modyfikacji danych.

Dostępni są dwaj zarządzani dostawcy danych — OleDb oraz Sql. Pierwszy z nich operuje na bazach danych zgodnych z OleDb (takich jak Microsoft Access, Oracle, itd.) natomiast drugi służy wyłącznie do obsługi baz SQL Server. Niemal bez wyjątków obiekty w pierwszym dostawcy odpowiadają obiektom w drugim. Jedyną różnicą jest stosowany prefiks — dla pierwszego z dostawców jest to OleDb, a dla drugiego Sql. Na przykład, obaj dostawcy udostępniają klasę służącą do zapewniania prostego dostępu do danych, są to odpowiednio klasy OleDbDataReader oraz SqlDataReader.

Ze względu na duże podobieństwo obu dostawców w niniejszym dodatku zostaną opisane wyłącznie klasy wykorzystywane do obsługi zarządzanego dostawcy OleDb. Jeśli gdzieś występują różnice pomiędzy obydwoma zarządzanymi dostawcami, zostaną one opisane w stosownej notatce. Ogólnie rzecz biorąc zarządzanego dostawcy Sql należy stosować wyłącznie w przypadku wykorzystania baz danych SQL Serwer; wykorzystuje on bowiem bardzo wydajne mechanizmy komunikacji z serwerem bazy danych, które można stosować wyłącznie do wymiany danych z SQL Serverem. We wszystkich pozostałych przypadkach, należy używać zarządzanego dostawcy OleDb.

Klasa OleDbCommand

Obiekty klasy OleDbCommand reprezentują polecenia SQL, które mają być wykonane przez źródło danych. Właściwości i metody tej klasy zostały przedstawione w tabeli C.13.

Tabela C.13. Właściwości i metody klasy OleDbCommand.

Właściwość	Opis
CommandText	Polecenie SQL które będzie wykonywane.
CommandTimeout	Limit czasu wykonywania polecenia, po jego przekroczeniu realizacja polecenia zostanie przerwana.
CommandType	Określa sposób interpretacji właściwości CommandText. Właściwość ta może przyjmować następujące wartości: StoredProcedure, TableDirect lub Text (wartość domyślna).
Connection	Określa obiekt OleDbConnection używany przez dane obiekt.
DesignTimeVisible	Określa czy podczas projektowania programu obiekt ten będzie wyświetlać jakiś komponent wizualny; właściwość ta jest przydatna dla programistów tworzących komponenty.
Parameters	Zwraca obiekt OleDbParameterCollection reprezentujący wszystkie parametry używane w danym poleceniu SQL.
Transaction	Obiekt OleDbTransaction używany przez dany obiekt.
UpdatedRowSource	Właściwość określa ilość wierszy jakie zostały objęte wynikami działania polecenia. Zazwyczaj, w przypadku poprawnego wykonania polecenia właściwość ta przyjmuje wartość 1, natomiast w przypadku wystąpienia jakichś błędów — wartość mniejszą od 1.
Metoda	Opis
Cancel	Przerywa wykonywanie polecenia.
CreateParameter	Tworzy obiekt OleDbParameter który zostanie wykorzystany w danym poleceniu.
Dispose	Usuwa obiekt polecenia.
ExecuteNonQuery	Wykonuje polecenie SQL, które nie zwraca żadnych danych wynikowych.
ExecuteReader	Zwraca obiekt klasy OleDbDataReader zawierający dane uzyskane w wyniku wykonania polecenia.
ExecuteScalar	Wykonuje polecenie i zwraca wartość pierwszej kolumny pierwszego wiersza uzyskanych wyników.
Prepare	Tworzy skompilowaną wersję polecenia SQL.
ResetCommandTimeout	Przywraca domyślną wartość właściwości CommandTimeout.

Klasa OleDbCommandBuilder

Obiekty tej klasy udostępniają prosty sposób generacji poleceń SQL, które będą wykonywane przez jakieś źródło danych. Właściwości i metody tej klasy zostały przedstawione w tabeli C.14.

Tabela C.14. Właściwości i metody klasy OleDbCommandBuilder.

Właściwość	Opis
DataAdapter	Nazwa obiektu OleDbDataAdapter dla którego będą generowane polecenia.
QuotePrefix	Określa prefiks jakim, w tworzonym poleceniu, należy poprzedzać nazwy obiektów źródła danych (na przykład: tbl w przypadku tabel, sp w przypadku procedur zachowanych i tak dalej).
QuoteSuffix	Określa końcówkę jaką należy dodawać do nazw obiektów źródła danych.
Metoda	Opis
Dispose	Usuwa bieżący obiekt polecenia.
GetDeleteCommand	Zwraca automatycznie wygenerowane polecenie SQL służące do usuwania wierszy ze źródła danych.
GetInsertCommand	Zwraca automatycznie wygenerowane polecenie SQL służące do wstawiania rekordów do źródła danych.
GetUpdateCommand	Zwraca automatycznie wygenerowane polecenie SQL służące do aktualizacji wierszy w źródle danych.
RefreshSchema	Pobiera schemat struktury źródła danych.
ShouldPersistSourceCommand	Określa czy należy zachować wartość właściwości CommandText.

Klasa OleDbConnection

Obiekty tej klasy reprezentują połączenia ze źródłami danych, ich właściwości, metody oraz zdarzenia zostały opisane w tabeli C.15.

Tabela C.15. Właściwości, metody oraz zdarzenia klasy OleDbConnection.

Właściwość	Opis
ConnectionString	Łańcuch znaków służący do otworzenia połączenia z bazą danych.
ConnectionTimeout	Okres czasu jaki należy czekać na otworzenie połączenia z bazą danych; przekroczeniu tego czasu zostanie zgłoszony błąd.
Database	Nazwa bazy danych z której będziemy korzystać po nawiązaniu połączenia.
DataSource	Nazwa bazy danych z jaką należy nawiązać połączenie.
Provider	Nazwa dostawcy bazy danych.
ReleaseObjectPool	Wskazuje, że pula obiektów reprezentujących połączenia ze źródłami danych może zostać wyczyszczona po zwolnieniu ostatniego dostawcy danych OleDb.
State	Bieżący stan połączenia.
Metoda	Opis
BeginTransaction	Rozpoczyna transakcję bazy danych. Metoda przeciążona.
ChangeDatabase (wartość)	Zmienia bieżącą bazę danych na inną, określoną przez argument wartość.
Close	Zamyka połączenie ze źródłem danych.
CreateCommand	Zwraca obiekt klasy OleDbCommand służący do wykonywania poleceń na danym źródle danych.
Dispose	Usuwa dany obiekt.
Open	Metoda podejmuje próbę otworzenia połączenia z bazą danych.
Zdarzenie	Opis
InfoMessage	Zachodzi gdy dostawca danych prześle jakiś komunikat. W procedurze obsługi tego zdarzenia jest stosowany argument będący obiektem klasy OleDbInfoMessageEventArgs. Klasa ta udostępnia następujące właściwości: ErrorCode — Jest to wartość typu HRESULT określająca standardowy kod błędu. Errors — Obiekt klasy OleDbErrorCollection zawierający obiekty reprezentujące wszystkie ostrzeżenie przesłane przez dostawcę. Message — Pełny tekst komunikatu o błędzie przesłanego przez dostawcę. Source — Nazwa obiektu, który wygenerował błąd.
StateChange	Zdarzenie zachodzi w momencie zmiany stanu połączenia. W procedurze obsługi tego zdarzenia wykorzystywany jest argument będący obiektem klasy StateChangeEventArgs. Klasa ta udostępnia dwie właściwości: CurrentState — Właściwość określa nowy stan połączenia. OriginalState — Właściwość określa poprzedni stan połączenia.

Klasa OleDbDataAdapter

Obiekty klasy OleDbDataAdapter reprezentują zbiór poleceń oraz połączeń ze źródłami danych, wykorzystywanymi do wypełniania obiektu DataSet. Właściwości, metody oraz zdarzenia tej klasy zostały przedstawione w tabeli C.16.

Tabela C.16. Właściwości, metody oraz zdarzenia klasy OleDbDataAdapter.

Właściwość	Opis
DeleteCommand	Zwraca obiekt klasy OleDbCommand zawierający polecenie SQL służące do usuwania danych z obiektu DataSet.
InsertCommand	Zwraca obiekt klasy OleDbCommand zawierający polecenie SQL służące do wstawiania danych do obiektu DataSet.
SelectCommand	Zwraca obiekt klasy OleDbCommand zawierający polecenie SQL służące do pobierania danych z obiektu DataSet.
UpdateCommand	Zwraca obiekt klasy OleDbCommand zawierający polecenie SQL służące do aktualizacji danych przechowywanych w obiekcie DataSet.
Metoda	Opis
Dispose	Usuwa ten obiekt.
Fill	Dodaje lub modyfikuje wiersze przechowywane w obiekcie DataSet, tak aby odpowiadały one zawartości źródła danych. Metoda przeciążona.
FillSchema	Dodaje obiekt DataTable do obiektu DataSet i odpowiednio konfiguruje schemat tabeli. Metoda przeciążona.
GetFillParameters	Zwraca tablicę obiektów IDataParameter używanych w poleceniach SELECT.
Update	Aktualizuje zawartość źródła danych na podstawie informacji zapisanych w obiekcie DataSet, wykorzystując do tego właściwości DeleteCommand, InsertCommand oraz UpdateCommand. Metoda przeciążona.
Zdarzenie	Opis
FillError	Zdarzenie zachodzi gdy podczas wykonywania metody Fill zostanie zgłoszony błąd. W procedurze obsługi tego zdarzenia wykorzystywany jest argument będący obiektem klasy FillErrorEventArgs. Klasa ta definiuje następujące właściwości: Continue — Określa czy operacja powinna być dalej realizowana. DataTable — Określa obiekt klasy DataTable który był aktualizowany w momencie wystąpienia błędu. Errors — Zwraca obiekt klasy Exception reprezentujący obsługiwany błąd. Values — Zwraca obiekt zawierający wartości znajdujące się w wierszu, który był aktualizowany w momencie wystąpienia błędu.
RowUpdated	Zdarzenie zachodzi w trakcie wykonywania metody Update, po wykonaniu polecenia SQL UPDATE. W procedurze obsługi tego zdarzenia wykorzystywany jest argument będący obiektem klasy OleDbRowUpdatedEventArgs. Klasa ta udostępnia następujące właściwości: Command — Zwraca obiekt OleDbCommand wykonany w efekcie wywołania metody Update. Errors — Zwraca obiekt Exception reprezentujący zgłoszone błędy. RecordsAffected — Określa ilość wierszy jakie zostały zmodyfikowane w efekcie wykonania polecenia. Row — Zwraca obiekt DataRow wykorzystany w metodzie Update. StatementType — Określ typ wykonanego polecenia SQL. Status — Obiekt klasy UpdateStatus reprezentujący status polecenia. TableMapping — Zwraca obiekt klasy DataTableMapping jaki został przesłany wraz z poleceniem UPDATE.
RowUpdating	Zdarzenie zachodzi podczas wykonywania metody Update, przed wykonaniem polecenia SQL UPDATE. W procedurze obsługi tego zdarzenia wykorzystywany jest argument będący obiektem klasy OleDbRowUpdatingEventArgs. Klasa ta udostępnia następujące właściwości: Command — Zwraca obiekt OleDbCommand jaki ma zostać wykonany przez metodę Update. Errors — Zwraca obiekt Exception reprezentujący zgłoszone błędy. Row — Zwraca obiekt DataRow wykorzystywany w metodzie Update. StatementType — Określ typ wykonywanego polecenia SQL. Status — Obiekt klasy UpdateStatus reprezentujący status polecenia. TableMapping — Zwraca obiekt klasy DataTableMapping jaki został przesłany wraz z poleceniem UPDATE.

Klasa OleDbDataReader

Klasa OleDbDataReader implementuje prostą, jednokierunkową metodę pobierania informacji ze źródła danych. Obiekty tej klasy przypominają obiekty DataSet, lecz kosztem mniejszych możliwości funkcjonalnych zapewniają lepszą efektywność działania. Właściwości oraz metody definiowane przez tę klasę zostały opisane w tabeli C.17.

Tabela C.17. Właściwości i metody klasy OleDbDataReader.

Właściwość	Opis
Depth	Określa głębokość obiektu czytelnika.
FieldCount	Określa ilość pól dostępnych w bieżącym rekordzie.
IsClosed	Określa czy obiekt czytelnika został zamknięty.
Item	Zwraca wartość wskazanej kolumny w jej oryginalnej postaci. Metoda przeciążona.
RecordsAffected	Określa ilość wierzy objętych wynikami działania polecenia. Zazwyczaj w przypadku poprawnego wykonania polecenia właściwość ta przyjmuje wartość 1, natomiast w razie wystąpienia błędów — wartość mniejszą od 1.
Metoda	Opis
Close	Zamyka obiekt OleDbDataReader.
GetBoolean(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu Boolean.
GetByte(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu Byte.
GetBytes(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako tablicę wartości typu Byte.
GetChar(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu Char.
GetChars(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako tablicę wartości typu Char.
GetDataTypeName(indeks)	Zwraca typ kolumny określonej za pomocą indeksu.
GetDataTime(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu DateTime.
GetDecimal(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu Decimal.
GetDefaultStream(indeks)	Zwraca obiekt klasy Stream.
GetDouble(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu Double.
GetFieldType(indeks)	Zwraca obiekt Type reprezentujący typ danych wskazanego obiektu.
GetFloat(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu Float.
GetGuid(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość globalnie unikalnego identyfikatora.
GetInt16(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako 16-bitową liczbę całkowitą.
GetInt32(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako 32-bitową liczbę całkowitą.
GetInt64(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako 64-bitową liczbę całkowitą.
GetName(indeks)	Zwraca nazwę kolumny określonej za pomocą indeksu.
GetOrdinal(nazwa)	Na podstawie nazwy kolumny, zwraca jej indeks.
GetString(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu String.
GetTimeSpan(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu, jako wartość typu TimeSpan.
GetValue(indeks)	Zwraca wartość kolumny określonej za pomocą indeksu w jej oryginalnym formacie.
GetValues(wartosci())	Zwraca wszystkie atrybuty bieżącego wiersza i zapisuje je w tablicy wartosci().
IsDBNull	Metoda stosowana do przedstawiania nieistniejących wartości.
NextResult	W przypadku wykorzystania wyników wykonania wsadowego polecenia SQL, metoda ta przesuwa obiekt czytelnika do następnego rekordu.
Read	Przesuwa obiekt czytelnika do następnego rekordu.

Klasy OleDbError oraz OleDbErrorCollection

Obiekty klasy OleDbError zbierają informacje dotyczące ostrzeżeń przesyłanych ze źródeł danych. Właściwości tej klasy zostały przedstawione w tabeli C.18.

Tabela C.18. Właściwości klasy OleDbError.

Właściwość	Opis
Message	Zawiera krótki opis błędu.
NativeError	Informacje o błędzie charakterystyczne dla używanej bazy danych.
Source	Zwraca obiekt, który wygenerował błąd.
SQLState	Zwraca standardowy, pięcioliterowy kod określający błąd, wygenerowany przez bazę danych.

W tabeli C.19 zostały opisane właściwości i metody klasy OleDbErrorCollection.

Właściwość	Opis
Count	Ilość błędów przechowywanych w kolekcji.
Item	Pobiera z kolekcji obiekt klasy OleDbError o określonym indeksie.
Metoda	Opis
CopyTo(tablica(), indeks)	Kopiuje całą zawartość kolekcji do tablicy tablica(), rozpoczynając od elementu o indeksie określonego za pomocą argumentu indeks.

Klasy OleDbParameter oraz OleDbParameterCollection

Obiekty klasy OleDbParameter reprezentują wartości przekazywane do bazy danych wraz z poleceniem i dostarczające dodatkowych informacji lub możliwości. Właściwości i metody tej klasy zostały przedstawione w tabeli C.20.

Tabela C.20. Właściwości i metody klasy OleDbParameter.

Właściwość	Opis
DataType	--> Właściwość zwraca obiekt Type określający typ danego parametru.[Author:p8R]
DbType	Typ danych źródła danych.
Direction	Określa w jaki sposób parametr będzie wykorzystywany. Dostępne wartości tej właściwości to: Input, InputOutput, Output oraz ReturnValue.
IsNullable	Określa czy parametr może zawierać wartość null.
ParameterName	Nazwa parametru.
Precision	Maksymalna ilość cyfr których można użyć do zapisania wartości parametru.
Scale	Maksymalna ilość miejsc dziesiętnych których można użyć od zapisania wartości parametru.
Size	Maksymalna dopuszczalna wielkość parametru.
SourceColumn	Nazwa kolumny źródła danych skojarzonej z obiektem DataSet i służącej do --> podawania lub [Author:p8R] zwracania wartości parametru.
SourceVersion	Określa wersję rekordu jaką należy wykorzystać podczas pobierania danych.
Value	Wartość parametru.
Metody	Opis
ToString	Zwraca wartość właściwości ParameterName.

Tabela C.21 zawiera właściwości i metody obiektów klasy OleDbParameterCollection.

Tabela C.21. Właściwości i metody klasy OleDbParameterCollection.

Właściwość	Opis
Count	Określa ilość obiektów klasy OleDbParameter przechowywanych w kolekcji.
Item	Pobiera z kolekcji obiekt klasy OleDbParameter na podstawie nazwy parametru bądź jego indeksu.
Metoda	Opis
Add	Dodaje parametr do kolekcji. Metoda przeciążona.
Clear	Usuwa z kolekcji wszystkie przechowywane w niej obiekty OleDbParameter.
Contains(nazwa)	Sprawdza czy w kolekcji jest już dostępny obiekt OleDbParameter reprezentujący parametr o podanej nazwie.
CopyTo(tablica(), indeks)	Kopiuje całą zawartość kolekcji do tablicy tablica(), rozpoczynając od elementu o indeksie określonego za pomocą argumentu indeks.
IndexOf	Zwraca indeks określonego parametru. Metoda przeciążona.
Insert(indeks, obiekt)	Wstawia obiekt OleDbParameter przekazany jako argument obiekt do kolekcji, w miejsce określone argumentem indeks.
Remove	Usuwa określony parametr z kolekcji. Metoda przeciążona.
RemoveAt	Usuwa z kolekcji obiekt OleDbParameter o określonym indeksie.

Klasa OleDbTransaction

Obiekty tej klasy reprezentują transakcje realizowane w źródle danych. Właściwości i metody tej klasy zostały przedstawione w tabeli C.22.

Tabela C.22. Właściwości i metody klasy OleDbTransaction.

Właściwość	Opis
IsolationLevel	Określa poziom izolacji dla danej transakcji. Właściwość ta może przyjmować następujące wartości: Chaos, ReadCommitted (wartość domyślna), ReadUncommitted, RepeatableRead, Serializable oraz Unspecified.
Metoda	Opis
Begin	Rozpoczyna transakcję, wszystkie polecenia i modyfikacje wykonywane po wywołaniu tej metody będą rejestrowane.
Commit	Zatwierdza wszelkie modyfikacje wprowadzone do momentu wywołania metody Begin.
RollBack	Odtwarza i anuluje wszystkie modyfikacje wprowadzone od momentu wywołania metody Begin.

2 Część I ♦ Podstawy obsługi systemu WhizBang (Nagłówek strony)

2 D:\Praca\HELION\ASP\Tekst\rDC-t.doc

Dodałem na podstawie dokumentacji .NET SDK

Autor się pomylił - dane na podstawie .NET SDK.

Uwaga, w dokumentacji .NET SDK Beta 2 nie ma tej właściwości.

Na podstawie dokumentacji

---