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.

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.

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.

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 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

.