Freigeben über


System.Data Namespace

Bietet Zugriff auf Klassen, die die ADO.NET Architektur darstellen. mit ADO.NET können Sie Komponenten erstellen, mit denen Daten aus mehreren Datenquellen effizient verwaltet werden.

Klassen

Name Beschreibung
Constraint

Stellt eine Einschränkung dar, die für ein oder DataColumn mehrere Objekte erzwungen werden kann.

ConstraintCollection

Stellt eine Auflistung von Einschränkungen für ein DataTable.

ConstraintException

Stellt die Ausnahme dar, die beim Versuch einer Aktion ausgelöst wird, die gegen eine Einschränkung verstößt.

DataColumn

Stellt das Schema einer Spalte in einer DataTable.

DataColumnChangeEventArgs

Stellt Daten für das ColumnChanging-Ereignis bereit.

DataColumnCollection

Stellt eine Auflistung von DataColumn Objekten für ein DataTable.

DataException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Fehler mithilfe ADO.NET Komponenten generiert werden.

DataReaderExtensions

Stellt Erweiterungsmethoden für DbDataReader.

DataRelation

Stellt eine Beziehung zwischen zwei DataTable Objekten zwischen übergeordneten/untergeordneten Objekten dar.

DataRelationCollection

Stellt die Auflistung von DataRelation Objekten für dieses DataSetObjekt dar.

DataRow

Stellt eine Datenzeile in einem DataTable.

DataRowBuilder

Der DataRowBuilder Typ unterstützt die .NET-Infrastruktur und soll nicht direkt aus Ihrem Code verwendet werden.

DataRowChangeEventArgs

Stellt Daten für die RowChangedEreignisse RowChanging, , , OnRowDeleting(DataRowChangeEventArgs)und OnRowDeleted(DataRowChangeEventArgs) die Ereignisse bereit.

DataRowCollection

Stellt eine Auflistung von Zeilen für ein DataTable.

DataRowComparer

Gibt eine Singletoninstanz der DataRowComparer<TRow> Klasse zurück.

DataRowComparer<TRow>

Vergleicht zwei DataRow Objekte für die Äquivalenz mithilfe eines wertbasierten Vergleichs.

DataRowExtensions

Definiert die Erweiterungsmethoden für die DataRow Klasse. Dies ist eine statische Klasse.

DataRowView

Stellt eine angepasste Ansicht eines .DataRow

DataSet

Stellt einen Speichercache von Daten dar.

DataSetSchemaImporterExtension

Dieses Mitglied unterstützt die .NET Framework-Infrastruktur und soll nicht direkt aus Ihrem Code verwendet werden.

DataSysDescriptionAttribute

Kennzeichnet eine Eigenschaft, ein Ereignis oder eine Erweiterung mit einer Beschreibung. Visuelle Designer können diese Beschreibung anzeigen, wenn sie auf das Element verweisen.

DataTable

Stellt eine Tabelle mit Speicherdaten dar.

DataTableClearEventArgs

Stellt Daten für die Clear() Methode bereit.

DataTableCollection

Stellt die Auflistung von Tabellen für die DataSet.

DataTableExtensions

Definiert die Erweiterungsmethoden für die DataTable Klasse. DataTableExtensions ist eine statische Klasse.

DataTableNewRowEventArgs

Stellt Daten für die NewRow() Methode bereit.

DataTableReader

Der DataTableReader ruft den Inhalt eines oder mehrerer DataTable-Objekte in Form eines oder mehrerer schreibgeschützter vorwärts gerichteter Resultsets ab.

DataView

Stellt eine datenbindierbare, angepasste Ansicht einer DataTable für Sortierung, Filterung, Suche, Bearbeitung und Navigation vorgesehenen Ansicht dar. Die DataView Daten werden nicht gespeichert, sondern stellt stattdessen eine verbundene Ansicht der entsprechenden DataTableDaten dar. Änderungen an den DataViewDaten der Daten wirken sich auf die DataTable. Änderungen an den DataTableDaten der Daten wirken sich auf alle DataViewdamit verbundenen Daten aus.

DataViewManager

Enthält einen Standardwert DataViewSettingCollection für jeden DataTable in einem DataSet.

DataViewSetting

Stellt die Standardeinstellungen für ApplyDefaultSort, , DataViewManager, RowFilter, RowStateFilter, Sortund Table für DataViews, die aus der DataViewManager.

DataViewSettingCollection

Enthält eine schreibgeschützte Auflistung von DataViewSetting Objekten für jedes DataTable objekt in einer DataSet.

DBConcurrencyException

Die Ausnahme, die DataAdapter während eines Einfüge-, Aktualisierungs- oder Löschvorgangs ausgelöst wird, wenn die Anzahl der betroffenen Zeilen gleich Null ist.

DeletedRowInaccessibleException

Stellt die Ausnahme dar, die ausgelöst wird, wenn eine Aktion für ein DataRow gelöschtes Element versucht wird.

DuplicateNameException

Stellt die Ausnahme dar, die ausgelöst wird, wenn während eines Add-Vorgangs in einem DataSet -related -Objekt ein doppelter Datenbankobjektname gefunden wird.

EntityCommandCompilationException

Stellt Fehler dar, die während der Befehlskompilierung auftreten; wenn eine Befehlsstruktur nicht erstellt werden konnte, um den Befehlstext darzustellen.

EntityCommandExecutionException

Stellt Fehler dar, die auftreten, wenn der zugrunde liegende Speicheranbieter den angegebenen Befehl nicht ausführen konnte. Diese Ausnahme umschließt in der Regel eine anbieterspezifische Ausnahme.

EntityException

Stellt Entitätsframework-bezogene Fehler dar, die EntityClient im Namespace auftreten. Dies EntityException ist die Basisklasse für alle Entitätsframework-Ausnahmen, die von der EntityClient.

EntityKey

Stellt einen dauerhaften Verweis auf ein Objekt bereit, das eine Instanz eines Entitätstyps ist.

EntityKeyMember

Stellt ein Schlüsselnamen- und Wertpaar dar, das Teil eines EntityKey.

EntitySqlException

Stellt Fehler dar, die beim Analysieren von Entity SQL-Befehlstext auftreten. Diese Ausnahme wird ausgelöst, wenn syntaktische oder semantische Regeln verletzt werden.

EnumerableRowCollection

Stellt eine Auflistung von Objekten dar, die DataRow von einer LINQ to DataSet-Abfrage zurückgegeben werden. Diese API unterstützt die .NET-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

EnumerableRowCollection<TRow>

Stellt eine Auflistung von Objekten dar, die DataRow von einer Abfrage zurückgegeben werden.

EnumerableRowCollectionExtensions

Enthält die Erweiterungsmethoden für die Datenzeilenauflistungsklassen.

EvaluateException

Stellt die Ausnahme dar, die ausgelöst wird, wenn die Expression Eigenschaft einer DataColumn nicht ausgewertet werden kann.

FillErrorEventArgs

Stellt Daten für das FillError Ereignis eines .DbDataAdapter

ForeignKeyConstraint

Stellt eine Aktionseinschränkung dar, die für eine Reihe von Spalten in einer Primärschlüssel-/Fremdschlüsselbeziehung erzwungen wird, wenn ein Wert oder eine Zeile entweder gelöscht oder aktualisiert wird.

InRowChangingEventException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie die EndEdit() Methode innerhalb des RowChanging Ereignisses aufrufen.

InternalDataCollectionBase

Stellt die Basisfunktionalität zum Erstellen von Sammlungen bereit.

InvalidCommandTreeException

Die Ausnahme, die ausgelöst wird, um anzugeben, dass eine Befehlsstruktur ungültig ist. Diese Ausnahme wird derzeit nicht überall im Entity Framework ausgelöst.

InvalidConstraintException

Stellt die Ausnahme dar, die ausgelöst wird, wenn sie fälschlicherweise versuchen, eine Beziehung zu erstellen oder darauf zuzugreifen.

InvalidExpressionException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie versuchen, ein Objekt DataColumn hinzuzufügen, das ein ungültiges Expression Element enthält.DataColumnCollection

MappingException

Die Ausnahme, die ausgelöst wird, wenn die Zuordnung verwandter Dienstanforderungen fehlschlägt.

MergeFailedEventArgs

Tritt auf, wenn ein Ziel und eine Quelle DataRow denselben Primärschlüsselwert aufweisen und die EnforceConstraints Eigenschaft auf "true" festgelegt ist.

MetadataException

Die Ausnahme, die ausgelöst wird, wenn metadatenbezogene Dienstanforderungen fehlschlagen.

MissingPrimaryKeyException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie versuchen, auf eine Zeile in einer Tabelle zuzugreifen, die keinen Primärschlüssel enthält.

NoNullAllowedException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie versuchen, einen NULL-Wert in eine Spalte einzufügen, auf die AllowDBNull festgelegt falseist.

ObjectNotFoundException

Die Ausnahme, die ausgelöst wird, wenn ein Objekt nicht vorhanden ist.

OperationAbortedException

Diese Ausnahme wird ausgelöst, wenn ein fortlaufender Vorgang vom Benutzer abgebrochen wird.

OptimisticConcurrencyException

Die Ausnahme, die ausgelöst wird, wenn eine optimistische Parallelitätsverletzung auftritt.

OrderedEnumerableRowCollection<TRow>

Stellt eine Auflistung sortierter DataRow Objekte dar, die von einer Abfrage zurückgegeben werden.

PropertyCollection

Stellt eine Auflistung von Eigenschaften dar, die hinzugefügt DataColumnwerden können, DataSetoder DataTable.

PropertyConstraintException

Ausnahmeklasse der Eigenschaftseinschränkung. Beachten Sie, dass diese Klasse über einen Zustand verfügt . Wenn Sie also auch ihre Internen ändern, kann es sich um eine wichtige Änderung handeln.

ProviderIncompatibleException

Die Ausnahme, die ausgelöst wird, wenn der zugrunde liegende Datenanbieter nicht mit entity Framework kompatibel ist.

ReadOnlyException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie versuchen, den Wert einer schreibgeschützten Spalte zu ändern.

RowNotInTableException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie versuchen, einen Vorgang für einen DataRow Vorgang auszuführen, der sich nicht in einer DataTable.

StateChangeEventArgs

Stellt Daten für das Zustandsänderungsereignis eines .NET-Datenanbieters bereit.

StatementCompletedEventArgs

Stellt zusätzliche Informationen für das StatementCompleted Ereignis bereit.

StrongTypingException

Die Ausnahme, die von einem stark typierten DataSet Ausgelöst wird, wenn der Benutzer auf einen DBNull Wert zugreift.

SyntaxErrorException

Stellt die Ausnahme dar, die ausgelöst wird, wenn die Expression Eigenschaft eines Objekts DataColumn einen Syntaxfehler enthält.

TypedDataSetGenerator

Wird verwendet, um eine stark typierte DataSet.

TypedDataSetGeneratorException

Die Ausnahme, die ausgelöst wird, wenn ein Namenskonflikt auftritt, während ein stark typierter DataSetWert generiert wird.

TypedTableBase<T>

Dieser Typ wird als Basisklasse für die Typ-ObjektgenerierungDataTable von Visual Studio und dem XSD.exe .NET Framework-Tool verwendet und ist nicht für die direkte Verwendung aus Dem Code vorgesehen.

TypedTableBaseExtensions

Enthält die Erweiterungsmethoden für die TypedTableBase<T> Klasse.

UniqueConstraint

Stellt eine Einschränkung für eine Gruppe von Spalten dar, in denen alle Werte eindeutig sein müssen.

UpdateException

Die Ausnahme, die ausgelöst wird, wenn Änderungen an Objektinstanzen nicht in der Datenquelle beibehalten werden können.

VersionNotFoundException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie versuchen, eine Version einer DataRow gelöschten Version zurückzugeben.

Schnittstellen

Name Beschreibung
IColumnMapping

Ordnet eine Datenquellenspalte einer DataSet Spalte zu und wird von der DataColumnMapping Klasse implementiert, die von .NET-Datenanbietern gemeinsam verwendet wird.

IColumnMappingCollection

Enthält eine Auflistung von DataColumnMapping-Objekten und wird von dem DataColumnMappingCollectionvon .NET-Datenanbietern verwendeten Typ implementiert.

IDataAdapter

Ermöglicht das Implementieren eines DataAdapter-Objekts und stellt eine Reihe von Methoden und zuordnungsbezogenen Eigenschaften dar, die zum Ausfüllen und Aktualisieren einer DataSet Datenquelle verwendet werden.

IDbDataAdapter Instanzen sind für Datenquellen vorgesehen, die relationale Datenbanken mit Textbefehlen (z. B. Transact-SQL) sind (oder ähneln), während IDataAdapter Instanzen einen beliebigen Datenquellentyp verwenden können.

IDataParameter

Stellt einen Parameter für ein Command -Objekt und optional die Zuordnung zu DataSet Spalten dar und wird von .NET-Datenanbietern implementiert, die auf Datenquellen zugreifen.

IDataParameterCollection

Sammelt alle Parameter, die für ein Command-Objekt und deren Zuordnungen zu DataSet Spalten relevant sind, und wird von .NET-Datenanbietern implementiert, die auf Datenquellen zugreifen.

IDataReader

Stellt ein Mittel zum Lesen eines oder mehrerer Vorwärtsdatenströme von Resultsets bereit, die durch Ausführen eines Befehls an einer Datenquelle abgerufen werden, und wird von .NET-Datenanbietern implementiert, die auf relationale Datenbanken zugreifen.

IDataRecord

Bietet Zugriff auf die Spaltenwerte in jeder Zeile für eine DataReaderUnd wird von .NET-Datenanbietern implementiert, die auf relationale Datenbanken zugreifen.

IDbCommand

Stellt eine SQL-Anweisung dar, die während der Verbindung mit einer Datenquelle ausgeführt wird und von .NET-Datenanbietern implementiert wird, die auf relationale Datenbanken zugreifen.

IDbConnection

Stellt eine offene Verbindung mit einer Datenquelle dar und wird von .NET-Datenanbietern implementiert, die auf relationale Datenbanken zugreifen.

IDbDataAdapter

Stellt einen Satz befehlsbezogener Eigenschaften dar, die zum Ausfüllen DataSet und Aktualisieren einer Datenquelle verwendet werden und von .NET-Datenanbietern implementiert werden, die auf relationale Datenbanken zugreifen.

IDbDataParameter

Wird von visual Basic .NET Data Designers verwendet, um einen Parameter für ein Command-Objekt und optional die Zuordnung zu DataSet Spalten darzustellen.

IDbTransaction

Stellt eine Transaktion dar, die an einer Datenquelle ausgeführt werden soll, und wird von .NET-Datenanbietern implementiert, die auf relationale Datenbanken zugreifen.

IExtendedDataRecord

Bietet Zugriff auf die Spaltenwerte in jeder Zeile eines für DbDataRecord ein DbDataReader.

ITableMapping

Ordnet eine Quelltabelle einer Tabelle in einem DataSet, und wird von der DataTableMapping Klasse implementiert, die von .NET-Datenanbietern verwendet wird.

ITableMappingCollection

Enthält eine Auflistung von TableMapping -Objekten und wird von dem DataTableMappingCollectionVon .NET-Datenanbietern verwendet.

Enumerationen

Name Beschreibung
AcceptRejectRule

Bestimmt die Aktion, die auftritt, wenn die AcceptChanges()- oder RejectChanges()-Methode für eine DataTable mit einem ForeignKeyConstraintaufgerufen wird.

CommandBehavior

Stellt eine Beschreibung der Ergebnisse der Abfrage und deren Auswirkungen auf die Datenbank bereit.

CommandType

Gibt an, wie eine Befehlszeichenfolge interpretiert wird.

ConflictOption

Gibt an, wie widersprüchliche Änderungen an der Datenquelle erkannt und aufgelöst werden.

ConnectionState

Beschreibt den aktuellen Zustand der Verbindung mit einer Datenquelle.

DataRowAction

Beschreibt eine Aktion, die für eine DataRowausgeführt wird.

DataRowState

Ruft den Status eines DataRow -Objekts ab.

DataRowVersion

Beschreibt die Version eines DataRow.

DataSetDateTime

Beschreibt das Serialisierungsformat für DateTime Spalten in einem DataSet.

DataViewRowState

Beschreibt die Version von Daten in einem DataRow.

DbType

Gibt den Datentyp eines Felds, einer Eigenschaft oder eines Parameter Objekts eines .NET-Datenanbieters an.

EntityState

Der Status eines Entitätsobjekts.

IsolationLevel

Gibt das Transaktionssperrverhalten für die Verbindung an.

KeyRestrictionBehavior

Identifiziert eine Liste von Verbindungszeichenfolgenparametern, die durch die KeyRestrictions-Eigenschaft identifiziert werden, die entweder zulässig oder nicht zulässig sind.

LoadOption

Steuert, wie die Werte aus der Datenquelle bei Verwendung der methode Load oder Load auf vorhandene Zeilen angewendet werden.

MappingType

Gibt an, wie ein DataColumn zugeordnet wird.

MissingMappingAction

Bestimmt die Aktion, die auftritt, wenn eine Zuordnung aus einer Quelltabelle oder einer Quellspalte fehlt.

MissingSchemaAction

Gibt die Aktion an, die beim Hinzufügen von Daten zum DataSet ausgeführt werden soll, und das erforderliche DataTable oder DataColumn fehlt.

ParameterDirection

Gibt den Typ eines Parameters innerhalb einer Abfrage relativ zum DataSetan.

PropertyAttributes

Gibt die Attribute einer Eigenschaft an.

Rule

Gibt die Aktion an, die auftritt, wenn ein ForeignKeyConstraint erzwungen wird.

SchemaSerializationMode

Gibt den Schema serialisierungsmodus für eine typierte DataSetan.

SchemaType

Gibt an, wie vorhandene Schemazuordnungen beim Ausführen eines FillSchema(DataSet, SchemaType) Vorgangs behandelt werden.

SerializationFormat

Bestimmt das Serialisierungsformat für ein DataSet.

SqlDbType

Gibt den SQL Server-spezifischen Datentyp eines Felds, einer Eigenschaft für die Verwendung in einem SqlParameteran.

StatementType

Gibt den Typ der SQL-Abfrage an, die von der klasse OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgsoder SqlRowUpdatingEventArgs verwendet werden soll.

UpdateRowSource

Gibt an, wie Abfragebefehlsergebnisse auf die Zeile angewendet werden, die aktualisiert wird.

UpdateStatus

Gibt die auszuführende Aktion in Bezug auf die aktuellen und verbleibenden Zeilen während eines Update(DataSet)an.

XmlReadMode

Gibt an, wie XML-Daten und ein relationales Schema in einem DataSetgelesen werden.

XmlWriteMode

Gibt an, wie XML-Daten und ein relationales Schema aus einem DataSetgeschrieben werden.

Delegaten

Name Beschreibung
DataColumnChangeEventHandler

Stellt die Methode dar, die das ColumnChanging Ereignis behandelt.

DataRowChangeEventHandler

Stellt die Methode dar, die die RowChangingEreignisse RowDeletedRowChangedRowDeletingund Ereignisse eines .DataTable

DataTableClearEventHandler

Stellt die Methode dar, die die Clear() Methode behandelt.

DataTableNewRowEventHandler

Stellt die Methode dar, die die NewRow() Methode behandelt.

FillErrorEventHandler

Stellt die Methode dar, die das FillError Ereignis behandelt.

MergeFailedEventHandler

Stellt die Methode dar, die das MergeFailed Ereignis behandelt.

StateChangeEventHandler

Stellt die Methode dar, die das StateChange Ereignis behandelt.

StatementCompletedEventHandler

Der Delegattyp für die Ereignishandler des StatementCompleted Ereignisses.

Hinweise

In einem getrennten Szenario wie dem Internet bietet ADO.NET die Tools zum Anfordern, Aktualisieren und Abgleichen von Daten in mehreren Ebenensystemen. Die ADO.NET-Architektur wird auch in Clientanwendungen wie Windows Forms oder HTML-Seiten implementiert, die von ASP.NET erstellt wurden.

Das Herzstück der ADO.NET Architektur ist die DataSet Klasse. Jede DataSet kann mehrere DataTable Objekte enthalten, wobei jede DataTable Daten aus einer einzelnen Datenquelle enthält, z. B. SQL Server.

Jede DataTable enthält eine DataColumnCollection--a --Auflistung von DataColumn Objekten --, die das Schema der einzelnen DataTableObjekte bestimmt. Die DataType Eigenschaft bestimmt den Datentyp, der von der DataColumn. Mit den ReadOnlyAllowDBNull Eigenschaften können Sie die Datenintegrität weiter garantieren. Mit der Expression Eigenschaft können Sie berechnete Spalten erstellen.

Wenn eine DataTable Beziehung zwischen übergeordneten und untergeordneten Elementen teilnimmt DataTable, wird die Beziehung durch Hinzufügen eines DataRelationDataRelationCollectionDataSet Objekts erstellt. Wenn eine solche Beziehung hinzugefügt wird, wird eine UniqueConstraint und eine ForeignKeyConstraint automatisch erstellt, abhängig von den Parametereinstellungen für den Konstruktor. Die UniqueConstraint Garantien, dass Werte, die in einer Spalte enthalten sind, eindeutig sind. Dies ForeignKeyConstraint bestimmt, welche Aktion mit der untergeordneten Zeile oder Spalte geschieht, wenn ein Primärschlüsselwert geändert oder gelöscht wird.

Mit dem System.Data.SqlClient Namespace (the.NET Framework Data Provider für SQL Server), dem System.Data.Odbc Namespace (the.NET Framework Data Provider für ODBC), dem System.Data.OleDb Namespace (the.NET Framework Data Provider für OLE DB) oder dem System.Data.OracleClient Namespace (.NET Framework Data Provider for Oracle) können Sie auf eine Datenquelle zugreifen, die zusammen mit einer DataSet. Each.NET Framework-Datenanbieter verfügt über einen entsprechenden DataAdapter , den Sie als Brücke zwischen einer Datenquelle und einer DataSet.