System.Data Przestrzeń nazw

Zapewnia dostęp do klas reprezentujących architekturę ADO.NET. ADO.NET umożliwia tworzenie składników, które efektywnie zarządzają danymi z wielu źródeł danych.

Klasy

Nazwa	Opis
Constraint	Reprezentuje ograniczenie, które można wymusić na co najmniej jednym DataColumn obiekcie.
ConstraintCollection	Reprezentuje kolekcję ograniczeń dla elementu DataTable.
ConstraintException	Reprezentuje wyjątek zgłaszany podczas próby wykonania akcji, która narusza ograniczenie.
DataColumn	Reprezentuje schemat kolumny w obiekcie DataTable.
DataColumnChangeEventArgs	Udostępnia dane dla zdarzenia ColumnChanging.
DataColumnCollection	Reprezentuje kolekcję DataColumn obiektów dla obiektu DataTable.
DataException	Reprezentuje wyjątek zgłaszany podczas generowania błędów przy użyciu składników ADO.NET.
DataReaderExtensions	Udostępnia metody rozszerzenia dla programu DbDataReader.
DataRelation	Reprezentuje relację elementu nadrzędnego/podrzędnego między dwoma DataTable obiektami.
DataRelationCollection	Reprezentuje kolekcję DataRelation obiektów dla tego DataSetobiektu .
DataRow	Reprezentuje wiersz danych w obiekcie DataTable.
DataRowBuilder	DataRowBuilder Typ obsługuje infrastrukturę platformy .NET i nie jest przeznaczony do użycia bezpośrednio z kodu.
DataRowChangeEventArgs	Dostarcza dane dla zdarzeń RowChanged, , RowChangingOnRowDeleting(DataRowChangeEventArgs)i OnRowDeleted(DataRowChangeEventArgs) .
DataRowCollection	Reprezentuje kolekcję wierszy dla elementu DataTable.
DataRowComparer	Zwraca pojedyncze wystąpienie DataRowComparer<TRow> klasy.
DataRowComparer<TRow>	Porównuje dwa DataRow obiekty równoważności przy użyciu porównania opartego na wartościach.
DataRowExtensions	Definiuje metody rozszerzenia klasy DataRow . Jest to klasa statyczna.
DataRowView	Reprezentuje dostosowany widok obiektu DataRow.
DataSet	Reprezentuje pamięć podręczną danych w pamięci.
DataSysDescriptionAttribute	Oznacza właściwość, zdarzenie lub rozszerzenie z opisem. Projektanci wizualizacji mogą wyświetlać ten opis podczas odwoływania się do elementu członkowskiego.
DataTable	Reprezentuje jedną tabelę danych w pamięci.
DataTableClearEventArgs	Dostarcza dane dla Clear() metody .
DataTableCollection	Reprezentuje kolekcję tabel dla elementu DataSet.
DataTableExtensions	Definiuje metody rozszerzenia klasy DataTable . DataTableExtensions jest klasą statyczną.
DataTableNewRowEventArgs	Dostarcza dane dla NewRow() metody .
DataTableReader	Obiekt DataTableReader uzyskuje zawartość jednego lub więcej obiektów DataTable w postaci jednego lub więcej zestawów wyników tylko do odczytu, tylko w przód.
DataView	Reprezentuje możliwy do powiązania, dostosowany widok DataTable elementu do sortowania, filtrowania, wyszukiwania, edytowania i nawigacji. Obiekt DataView nie przechowuje danych, ale reprezentuje połączony widok odpowiadającego DataTablemu elementu . DataViewZmiany danych będą mieć wpływ na element DataTable. DataTableZmiany danych będą mieć wpływ na wszystkie skojarzone z nim daneDataView.
DataViewManager	Zawiera wartość domyślną DataViewSettingCollection dla każdego DataTable elementu w obiekcie DataSet.
DataViewSetting	Reprezentuje ustawienia domyślne dla ApplyDefaultSortelementów , , DataViewManager, RowStateFilterRowFilter, Sorti Table dla elementów DataView utworzonych na podstawie elementu DataViewManager.
DataViewSettingCollection	Zawiera kolekcję DataViewSetting obiektów tylko do odczytu dla każdego DataTable obiektu w obiekcie DataSet.
DBConcurrencyException	Wyjątek zgłaszany przez DataAdapter operację wstawiania, aktualizowania lub usuwania, jeśli liczba wierszy, których dotyczy problem, jest równa zero.
DeletedRowInaccessibleException	Reprezentuje wyjątek zgłaszany podczas próby wykonania akcji w DataRow obiekcie, który został usunięty.
DuplicateNameException	Reprezentuje wyjątek zgłaszany podczas napotkania zduplikowanej nazwy obiektu bazy danych podczas operacji dodawania w DataSet obiekcie -related.
EnumerableRowCollection	Reprezentuje kolekcję DataRow obiektów zwracanych z zapytania LINQ to DataSet. Ten interfejs API obsługuje infrastrukturę platformy .NET i nie jest przeznaczony do użycia bezpośrednio z kodu.
EnumerableRowCollection<TRow>	Reprezentuje kolekcję DataRow obiektów zwracanych z zapytania.
EnumerableRowCollectionExtensions	Zawiera metody rozszerzenia dla klas zbierania wierszy danych.
EvaluateException	Reprezentuje wyjątek zgłaszany, gdy Expression nie można ocenić właściwości obiektu DataColumn .
FillErrorEventArgs	Dostarcza dane dla FillError zdarzenia elementu DbDataAdapter.
ForeignKeyConstraint	Reprezentuje ograniczenie akcji wymuszone dla zestawu kolumn w relacji klucza podstawowego/klucza obcego, gdy wartość lub wiersz zostanie usunięta lub zaktualizowana.
InRowChangingEventException	Reprezentuje wyjątek zgłaszany podczas wywoływania EndEdit() metody w ramach RowChanging zdarzenia.
InternalDataCollectionBase	Udostępnia podstawowe funkcje tworzenia kolekcji.
InvalidConstraintException	Reprezentuje wyjątek zgłaszany podczas nieprawidłowej próby utworzenia lub uzyskania dostępu do relacji.
InvalidExpressionException	Reprezentuje wyjątek zgłaszany podczas próby dodania elementu DataColumn zawierającego nieprawidłowy Expression element do elementu DataColumnCollection.
MergeFailedEventArgs	Występuje, gdy element docelowy i źródło DataRow mają tę samą wartość klucza podstawowego, a EnforceConstraints właściwość ma wartość true.
MissingPrimaryKeyException	Reprezentuje wyjątek zgłaszany podczas próby uzyskania dostępu do wiersza w tabeli, która nie ma klucza podstawowego.
NoNullAllowedException	Reprezentuje wyjątek zgłaszany podczas próby wstawienia wartości null do kolumny, w której AllowDBNull ustawiono wartość false.
OrderedEnumerableRowCollection<TRow>	Reprezentuje kolekcję uporządkowanych DataRow obiektów zwracanych z zapytania.
PropertyCollection	Reprezentuje kolekcję właściwości, które można dodać do DataColumn, DataSetlub DataTable.
ReadOnlyException	Reprezentuje wyjątek zgłaszany podczas próby zmiany wartości kolumny tylko do odczytu.
RowNotInTableException	Reprezentuje wyjątek zgłaszany podczas próby wykonania operacji na obiekcie, który DataRow nie znajduje się w DataTableobiekcie .
StateChangeEventArgs	Dostarcza dane dla zdarzenia zmiany stanu dostawcy danych platformy .NET.
StatementCompletedEventArgs	Zawiera dodatkowe informacje o StatementCompleted zdarzeniu.
StrongTypingException	Wyjątek zgłaszany przez silnie typizowane DataSet , gdy użytkownik uzyskuje DBNull dostęp do wartości.
SyntaxErrorException	Reprezentuje wyjątek zgłaszany, gdy Expression właściwość obiektu DataColumn zawiera błąd składni.
TypedTableBase<T>	Ten typ jest używany jako klasa bazowa do generowania typuDataTable obiektów przez program Visual Studio i narzędzia XSD.exe .NET Framework i nie jest przeznaczony do użycia bezpośrednio z kodu.
TypedTableBaseExtensions	Zawiera metody rozszerzenia dla TypedTableBase<T> klasy .
UniqueConstraint	Reprezentuje ograniczenie dotyczące zestawu kolumn, w których wszystkie wartości muszą być unikatowe.
VersionNotFoundException	Reprezentuje wyjątek zgłaszany podczas próby zwrócenia wersji DataRow , która została usunięta.

Interfejsy

Nazwa	Opis
IColumnMapping	Kojarzy kolumnę źródła danych z kolumną i jest implementowana przez DataColumnMapping klasęDataSet, która jest używana przez dostawców danych platformy .NET.
IColumnMappingCollection	Zawiera kolekcję obiektów DataColumnMapping i jest implementowana przez DataColumnMappingCollectionobiekt , który jest używany przez dostawców danych platformy .NET.
IDataAdapter	Umożliwia obiektowi zaimplementowanie elementu DataAdapter i reprezentuje zestaw metod i właściwości związanych z mapowaniem, które są używane do wypełniania i aktualizowania DataSet źródła danych oraz aktualizowania go. IDbDataAdapter wystąpienia są przeznaczone dla źródeł danych, które są (lub podobne) relacyjnych baz danych z tekstowymi poleceniami (takimi jak Transact-SQL), podczas gdy IDataAdapter wystąpienia mogą używać dowolnego typu źródła danych.
IDataParameter	Reprezentuje parametr obiektu Command i opcjonalnie jego mapowanie na DataSet kolumny i jest implementowane przez dostawców danych platformy .NET, którzy uzyskują dostęp do źródeł danych.
IDataParameterCollection	Zbiera wszystkie parametry istotne dla obiektu Command i ich mapowania na DataSet kolumny i jest implementowane przez dostawców danych platformy .NET, którzy uzyskują dostęp do źródeł danych.
IDataReader	Zapewnia metodę odczytywania jednego lub większej liczby strumieni tylko do przodu zestawów wyników uzyskanych przez wykonanie polecenia w źródle danych i jest implementowany przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.
IDataRecord	Zapewnia dostęp do wartości kolumn w każdym wierszu dla elementu DataReaderi jest implementowany przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.
IDbCommand	Reprezentuje instrukcję SQL wykonywaną podczas nawiązywania połączenia ze źródłem danych i jest implementowana przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.
IDbConnection	Reprezentuje otwarte połączenie ze źródłem danych i jest implementowane przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.
IDbDataAdapter	Reprezentuje zestaw właściwości związanych z poleceniami, które są używane do wypełniania DataSet i aktualizowania źródła danych i są implementowane przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.
IDbDataParameter	Używany przez projektantów danych platformy .NET w języku Visual Basic do reprezentowania parametru obiektu Command i opcjonalnie mapowania na DataSet kolumny.
IDbTransaction	Reprezentuje transakcję do wykonania w źródle danych i jest implementowana przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych.
ITableMapping	Kojarzy tabelę źródłową z tabelą DataSetw obiekcie i jest implementowana przez DataTableMapping klasę, która jest używana powszechnie przez dostawców danych platformy .NET.
ITableMappingCollection	Zawiera kolekcję obiektów TableMapping i jest implementowana przez DataTableMappingCollectionelement , który jest używany powszechnie przez dostawców danych platformy .NET.

Wyliczenia

Nazwa	Opis
AcceptRejectRule	Określa akcję, która występuje, gdy metoda AcceptChanges() lub RejectChanges() jest wywoływana na DataTable z ForeignKeyConstraint.
CommandBehavior	Zawiera opis wyników zapytania i jego wpływu na bazę danych.
CommandType	Określa sposób interpretowania ciągu polecenia.
ConflictOption	Określa sposób wykrywania i rozwiązywania konfliktów zmian w źródle danych.
ConnectionState	Opisuje bieżący stan połączenia ze źródłem danych.
DataRowAction	Opisuje akcję wykonywaną na DataRow.
DataRowState	Pobiera stan obiektu DataRow.
DataRowVersion	Opisuje wersję DataRow.
DataSetDateTime	Opisuje format serializacji kolumn DateTime w DataSet.
DataViewRowState	Opisuje wersję danych w DataRow.
DbType	Określa typ danych pola, właściwość lub obiekt Parameter dostawcy danych platformy .NET.
IsolationLevel	Określa zachowanie blokowania transakcji dla połączenia.
KeyRestrictionBehavior	Identyfikuje listę parametrów połączenia zidentyfikowanych przez właściwość KeyRestrictions, które są dozwolone lub niedozwolone.
LoadOption	Określa sposób stosowania wartości ze źródła danych do istniejących wierszy podczas używania metody Load lub Load.
MappingType	Określa sposób mapowanie DataColumn.
MissingMappingAction	Określa akcję, która występuje, gdy brakuje mapowania z tabeli źródłowej lub kolumny źródłowej.
MissingSchemaAction	Określa akcję do wykonania podczas dodawania danych do DataSet i brak wymaganych DataTable lub DataColumn.
ParameterDirection	Określa typ parametru w zapytaniu względem DataSet.
Rule	Wskazuje akcję, która występuje, gdy ForeignKeyConstraint jest wymuszana.
SchemaSerializationMode	Wskazuje tryb serializacji schematu dla typizowanego DataSet.
SchemaType	Określa sposób obsługi istniejących mapowań schematów podczas wykonywania operacji FillSchema(DataSet, SchemaType).
SerializationFormat	Określa format serializacji dla DataSet.
SqlDbType	Określa typ danych specyficzny dla programu SQL Server pola, właściwości do użycia w SqlParameter.
StatementType	Określa typ zapytania SQL, który ma być używany przez klasę OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgslub SqlRowUpdatingEventArgs.
UpdateRowSource	Określa sposób stosowania wyników polecenia zapytania do aktualizowanego wiersza.
UpdateStatus	Określa akcję do wykonania w odniesieniu do bieżących i pozostałych wierszy podczas Update(DataSet).
XmlReadMode	Określa sposób odczytywania danych XML i schematu relacyjnego do DataSet.
XmlWriteMode	Określa sposób pisania danych XML i schematu relacyjnego z DataSet.

Delegaci

Nazwa	Opis
DataColumnChangeEventHandler	Reprezentuje metodę, która będzie obsługiwać ColumnChanging zdarzenie.
DataRowChangeEventHandler	Reprezentuje metodę, która będzie obsługiwać RowChangingzdarzenia DataTable, , RowChangedRowDeletingi RowDeleted .
DataTableClearEventHandler	Reprezentuje metodę, która obsługuje metodę Clear() .
DataTableNewRowEventHandler	Reprezentuje metodę, która obsługuje metodę NewRow() .
FillErrorEventHandler	Reprezentuje metodę, która będzie obsługiwać FillError zdarzenie.
MergeFailedEventHandler	Reprezentuje metodę, która będzie obsługiwać MergeFailed zdarzenie.
StateChangeEventHandler	Reprezentuje metodę, która będzie obsługiwać StateChange zdarzenie.
StatementCompletedEventHandler	Typ delegata dla programów obsługi zdarzeń StatementCompleted zdarzenia.

Uwagi

W scenariuszu bez połączenia, takim jak Internet, ADO.NET udostępnia narzędzia do żądania, aktualizowania i uzgadniania danych w wielu systemach warstwowych. Architektura ADO.NET jest również implementowana w aplikacjach klienckich, takich jak Windows Forms lub strony HTML utworzone przez ASP.NET.

Centralnym elementem architektury ADO.NET jest DataSet klasa . Każdy może zawierać wiele DataTable obiektów, z których każdy DataSetDataTable zawiera dane z jednego źródła danych, takiego jak program SQL Server.

Każda z nich DataTable zawiera DataColumnCollectionkolekcję DataColumn obiektów — która określa schemat każdego DataTableobiektu . Właściwość DataType określa typ danych przechowywanych przez DataColumnelement . Właściwości ReadOnly i AllowDBNull pozwalają dodatkowo zagwarantować integralność danych. Właściwość Expression umożliwia konstruowanie kolumn obliczeniowych.

Jeśli obiekt DataTable uczestniczy w relacji elementu nadrzędnego/podrzędnego z innym DataTableelementem , relacja jest tworzona przez dodanie DataRelation elementu do DataRelationCollectionDataSet obiektu . Po dodaniu takiej relacji elementy i UniqueConstraint i ForeignKeyConstraint są tworzone automatycznie, w zależności od ustawień parametru konstruktora. Gwarancje UniqueConstraint , że wartości zawarte w kolumnie są unikatowe. Określa ForeignKeyConstraint , jaka akcja będzie miała miejsce w wierszu lub kolumnie podrzędnej po zmianie lub usunięciu wartości klucza podstawowego.

Korzystając z System.Data.SqlClient przestrzeni nazw (the.NET Framework Data Provider for SQL Server), System.Data.Odbc przestrzeni nazw (the.NET Framework Data Provider for ODBC), System.Data.OleDb przestrzeni nazw (the.NET Framework Data Provider for OLE DB) lub System.Data.OracleClient przestrzeni nazw (dostawcy danych programu .NET Framework dla oracle) można uzyskać dostęp do źródła danych, które ma być używane razem z DataSet. Each.NET Dostawca danych framework ma odpowiedni element DataAdapter , którego używasz jako mostka między źródłem danych a elementem DataSet.