System.Data Przestrzeń nazw
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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 naruszającej 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 |
Typ |
DataRowChangeEventArgs |
Dostarcza dane dla zdarzeń RowChanged, RowChanging, OnRowDeleting(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 pod kątem równoważności przy użyciu porównania opartego na wartościach. |
DataRowExtensions |
Definiuje metody rozszerzenia dla DataRow klasy . Jest to klasa statyczna. |
DataRowView |
Reprezentuje dostosowany widok obiektu DataRow. |
DataSet |
Reprezentuje pamięć podręczną danych w pamięci. |
DataSetSchemaImporterExtension |
Ten element członkowski obsługuje infrastrukturę programu .NET Framework i nie jest przeznaczony do użycia bezpośrednio w kodzie. |
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 dla DataTable klasy . DataTableExtensions jest klasą statyczną. |
DataTableNewRowEventArgs |
Dostarcza dane dla NewRow() metody . |
DataTableReader |
Obiekt DataTableReader uzyskuje zawartość co najmniej jednego obiektu w postaci jednego lub większej DataTable liczby zestawów wyników tylko do odczytu, tylko do przodu. |
DataView |
Reprezentuje możliwy do powiązania, dostosowany widok elementu DataTable do sortowania, filtrowania, wyszukiwania, edytowania i nawigacji. Obiekt DataView nie przechowuje danych, ale reprezentuje połączony widok odpowiadającego DataTablemu widoku . DataViewZmiany danych w danych będą mieć wpływ na element DataTable. DataTableZmiany danych w danych będą wpływać na wszystkie DataViewskojarzone z nim dane. |
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, wynosi zero. |
DeletedRowInaccessibleException |
Reprezentuje wyjątek zgłaszany podczas próby wykonania akcji dla DataRow elementu, który został usunięty. |
DuplicateNameException |
Reprezentuje wyjątek zgłaszany podczas napotkania zduplikowanej nazwy obiektu bazy danych podczas operacji dodawania w obiekcie powiązanym DataSet . |
EntityCommandCompilationException |
Reprezentuje błędy występujące podczas kompilacji poleceń; gdy nie można utworzyć drzewa poleceń do reprezentowania tekstu polecenia. |
EntityCommandExecutionException |
Reprezentuje błędy występujące, gdy podstawowy dostawca magazynu nie może wykonać określonego polecenia. Ten wyjątek zwykle opakowuje wyjątek specyficzny dla dostawcy. |
EntityException |
Reprezentuje błędy związane z programem Entity Framework występujące w |
EntityKey |
Zapewnia trwałe odwołanie do obiektu, który jest wystąpieniem typu jednostki. |
EntityKeyMember |
Reprezentuje parę nazwa i wartość klucza, która jest częścią klasy EntityKey. |
EntitySqlException |
Reprezentuje błędy występujące podczas analizowania tekstu polecenia Entity SQL. Ten wyjątek jest zgłaszany w przypadku naruszenia reguł składniowych lub semantycznych. |
EnumerableRowCollection |
Reprezentuje kolekcję DataRow obiektów zwróconych 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 zwróconych 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 obiektu DbDataAdapter. |
ForeignKeyConstraint |
Reprezentuje ograniczenie akcji wymuszane na zestawie 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. |
InvalidCommandTreeException |
Zgłoszony wyjątek wskazujący, że drzewo poleceń jest nieprawidłowe. Ten wyjątek nie jest obecnie zgłaszany w żadnym miejscu w programie Entity Framework. |
InvalidConstraintException |
Reprezentuje wyjątek zgłaszany podczas nieprawidłowej próby utworzenia relacji lub uzyskania do jej dostępu. |
InvalidExpressionException |
Reprezentuje wyjątek zgłaszany podczas próby dodania elementu DataColumn zawierającego nieprawidłowy Expression element do elementu DataColumnCollection. |
MappingException |
Wyjątek zgłaszany podczas mapowania powiązanych żądań obsługi kończy się niepowodzeniem. |
MergeFailedEventArgs |
Występuje, gdy element docelowy i źródło |
MetadataException |
Wyjątek zgłaszany, gdy żądania obsługi powiązane z metadanymi kończą się niepowodzeniem. |
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 |
ObjectNotFoundException |
Wyjątek zgłaszany, gdy obiekt nie jest obecny. |
OperationAbortedException |
Ten wyjątek jest zgłaszany, gdy trwa operacja została przerwana przez użytkownika. |
OptimisticConcurrencyException |
Wyjątek zgłaszany w przypadku wystąpienia optymistycznego naruszenia współbieżności. |
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. |
PropertyConstraintException |
Klasa wyjątków ograniczeń właściwości. Należy pamiętać, że ta klasa ma stan — więc jeśli zmienisz nawet jego wewnętrzne elementy, może to być zmiana powodująca niezgodność. |
ProviderIncompatibleException |
Wyjątek zgłaszany, gdy podstawowy dostawca danych jest niezgodny z programem Entity Framework. |
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 DataRow , który nie znajduje się w obiekcie DataTable. |
StateChangeEventArgs |
Dostarcza dane dotyczące 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 |
SyntaxErrorException |
Reprezentuje wyjątek zgłaszany, gdy Expression właściwość elementu DataColumn zawiera błąd składniowy. |
TypedDataSetGenerator |
Służy do tworzenia silnie typizowanego DataSetelementu . |
TypedDataSetGeneratorException |
Wyjątek zgłaszany w przypadku konfliktu nazw podczas generowania silnie typizowanego DataSetelementu . |
TypedTableBase<T> |
Ten typ jest używany jako klasa bazowa do generowania obiektów wpisanychDataTable przez program Visual Studio i narzędzie 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. |
UpdateException |
Wyjątek zgłaszany, gdy modyfikacje wystąpień obiektów nie mogą być utrwalane w źródle danych. |
VersionNotFoundException |
Reprezentuje wyjątek zgłaszany podczas próby zwrócenia wersji usuniętej DataRow . |
Interfejsy
IColumnMapping |
Kojarzy kolumnę źródła danych z kolumną i jest implementowana przez DataColumnMapping klasęDataSet, która jest używana powszechnie przez dostawców danych platformy .NET. |
IColumnMappingCollection |
Zawiera kolekcję obiektów DataColumnMapping i jest implementowana przez DataColumnMappingCollectionobiekt , który jest używany powszechnie przez dostawców danych platformy .NET. |
IDataAdapter |
Umożliwia zaimplementowanie obiektu DataAdapter i reprezentuje zestaw metod i mapowanie właściwości związanych z akcjami, które są używane do wypełniania i aktualizowania DataSet źródła danych i aktualizacji. IDbDataAdapter wystąpienia są przeznaczone dla źródeł danych, które są (lub podobne) relacyjnych baz danych z poleceniami tekstowymi (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 mapowanie na DataSet kolumny i jest implementowany 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 co najmniej jednego strumienia 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 |
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 jest implementowany przez dostawców danych platformy .NET, którzy uzyskują dostęp do relacyjnych baz danych. |
IDbDataParameter |
Używany przez projektantów danych .NET w języku Visual Basic do reprezentowania parametru do 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. |
IExtendedDataRecord |
Zapewnia dostęp do wartości kolumn w każdym wierszu elementu DbDataRecord dla elementu DbDataReader. |
ITableMapping |
Kojarzy tabelę źródłową z tabelą DataSetw obiekcie i jest implementowana przez DataTableMapping klasę, która jest używana 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
AcceptRejectRule |
Określa akcję, która występuje, gdy AcceptChanges() metoda lub RejectChanges() jest wywoływana na obiekcie DataTable z elementem 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 obiekcie DataRow. |
DataRowState |
Pobiera stan DataRow obiektu. |
DataRowVersion |
Opisuje wersję obiektu DataRow. |
DataSetDateTime |
Opisuje format serializacji kolumn DateTime w obiekcie DataSet. |
DataViewRowState |
Opisuje wersję danych w obiekcie DataRow. |
DbType |
Określa typ danych pola, właściwości lub |
EntityState |
Stan obiektu jednostki. |
IsolationLevel |
Określa zachowanie blokowania transakcji dla połączenia. |
KeyRestrictionBehavior |
Identyfikuje listę parametrów połączenia zidentyfikowanych przez |
LoadOption |
Określa sposób stosowania wartości ze źródła danych do istniejących wierszy podczas korzystania z Load metody lub Load . |
MappingType |
Określa, jak DataColumn jest mapowany. |
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ę, która ma być wykonywana podczas dodawania danych do DataSet elementów i wymaganych DataTable lub DataColumn brakujących. |
ParameterDirection |
Określa typ parametru w zapytaniu względem parametru DataSet. |
PropertyAttributes |
Określa atrybuty właściwości. |
Rule |
Wskazuje akcję, która występuje, gdy ForeignKeyConstraint jest wymuszana. |
SchemaSerializationMode |
Wskazuje tryb serializacji schematu dla typu DataSet. |
SchemaType |
Określa sposób obsługi istniejących mapowań schematów podczas wykonywania FillSchema(DataSet, SchemaType) operacji. |
SerializationFormat |
Określa format serializacji dla klasy DataSet. |
SqlDbType |
Określa typ danych specyficzny dla SQL Server pola, właściwości do użycia w obiekcie SqlParameter. |
StatementType |
Określa typ zapytania SQL, który ma być używany przez klasę OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, lub SqlRowUpdatedEventArgsSqlRowUpdatingEventArgs . |
UpdateRowSource |
Określa sposób stosowania wyników polecenia zapytania do aktualizowanego wiersza. |
UpdateStatus |
Określa akcję do podjęcia w odniesieniu do bieżących i pozostałych wierszy podczas elementu Update(DataSet). |
XmlReadMode |
Określa sposób odczytywania danych XML i schematu relacyjnego do elementu DataSet. |
XmlWriteMode |
Określa sposób zapisywania danych XML i schematu relacyjnego z elementu DataSet. |
Delegaci
DataColumnChangeEventHandler |
Reprezentuje metodę, która będzie obsługiwać ColumnChanging zdarzenie. |
DataRowChangeEventHandler |
Reprezentuje metodę, która będzie obsługiwać RowChangingzdarzenia , RowChanged, RowDeletingi RowDeleted elementu DataTable. |
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ń zdarzenia StatementCompleted . |
Uwagi
W scenariuszu rozłączonym, 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 na stronach HTML utworzonych przez ASP.NET.
Centralnym elementem DataSet architektury ADO.NET jest klasa . Każdy DataSet może zawierać wiele DataTable obiektów, z których każdy DataTable zawiera dane z jednego źródła danych, na przykład 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 DataColumnobiekt . Właściwości ReadOnly i AllowDBNull umożliwiają dalsze zagwarantowanie integralności danych. Właściwość Expression umożliwia konstruowanie kolumn obliczeniowych.
Jeśli element DataTable uczestniczy w relacji nadrzędnej/podrzędnej z innym DataTableelementem , relacja jest konstruowana przez dodanie DataRelation obiektu do DataRelationCollectionDataSet obiektu. Po dodaniu takiej relacji obiekt i ForeignKeyConstraint i UniqueConstraint są tworzone automatycznie, w zależności od ustawień parametrów konstruktora. Gwarancje UniqueConstraint , że wartości zawarte w kolumnie są unikatowe. Określa ForeignKeyConstraint , jaka akcja będzie wykonywana w wierszu podrzędnym lub kolumnie po zmianie lub usunięciu wartości klucza podstawowego.
Korzystając z System.Data.SqlClient przestrzeni nazw (dostawca danych platformy the.NET dla SQL Server), przestrzeni nazw (dostawca danych platformy the.NET dla ODBC), System.Data.OdbcSystem.Data.OleDb przestrzeni nazw (dostawca danych platformy the.NET framework dla OLE DB) lub System.Data.OracleClient przestrzeni nazw (dostawcy danych .NET Framework dla oracle) można uzyskać dostęp do źródła danych do użycia razem z usługą DataSet. dostawca danych platformy Each.NET Framework ma odpowiedni element DataAdapter , który jest używany jako mostek między źródłem danych a elementem DataSet.