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.
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
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.
Item
Właściwość zwraca ograniczenie (obiekt klasy Constraint) zapisane w kolekcji, określając je na podstawie podanej nazwy bądź indeksu.
Metoda
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
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.
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.
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.
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.
ToString
Zwraca obiekt klasy Expression dla danej kolumny (jeśli istnieje), a w przeciwnym przypadku nazwę kolumny.
Dodałem na podstawie dokumentacji .NET SDK
lukaszwalda