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

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 DataRowBuilder obsługuje infrastrukturę platformy .NET i nie jest przeznaczony do użycia bezpośrednio z kodu.

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 EntityClient przestrzeni nazw. Jest EntityException to klasa bazowa dla wszystkich wyjątków programu Entity Framework zgłaszanych przez element EntityClient.

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 DataRow mają taką samą wartość klucza podstawowego, a EnforceConstraints właściwość jest ustawiona na wartość true.

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 falsewartość .

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 DBNull dostęp do wartości.

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 DataReaderelementu i 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 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 Parameter obiektu dostawcy danych platformy .NET.

EntityState

Stan obiektu jednostki.

IsolationLevel

Określa zachowanie blokowania transakcji dla połączenia.

KeyRestrictionBehavior

Identyfikuje listę parametrów połączenia zidentyfikowanych przez KeyRestrictions właściwość, która jest dozwolona lub niedozwolona.

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.