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
.