System.Data-Namespace
Der System.Data-Namespace stellt Zugriff auf Klassen bereit, die die ADO.NET-Architektur darstellen. Mit ADO.NET können Sie Komponenten erstellen, die Daten aus mehreren Datenquellen effizient verwalten.
In einem nicht verbundenen Szenario (z. B. dem Internet) stellt ADO.NET die Tools zum Anfordern, Aktualisieren und Abgleichen von Daten in Systemen mit mehreren Ebenen bereit. Die ADO.NET-Architektur wird außerdem in Clientanwendungen wie Windows Forms oder in durch ASP.NET erstellten HTML-Seiten implementiert.
Das Kernstück der ADO.NET-Architektur ist die DataSet-Klasse. Jedes DataSet kann mehrere DataTable-Objekte enthalten, wobei jede DataTable Daten aus einer einzigen Datenquelle enthält, z. B. SQL Server.
Jede DataTable enthält eine DataColumnCollection (eine Auflistung von DataColumn-Objekten), die das Schema der jeweiligen DataTable bestimmt. Die DataType-Eigenschaft bestimmt den Typ der Daten, die in der DataColumn enthalten sind. Mit der ReadOnly-Eigenschaft und der AllowDBNull-Eigenschaft können Sie weiterhin Datenintegrität garantieren. Mit der Expression-Eigenschaft können Sie berechnete Spalten erstellen.
Wenn eine DataTable Teil einer Beziehung zwischen übergeordneten und untergeordneten Elementen mit einer anderen DataTable ist, wird die Beziehung erstellt, indem der DataRelationCollection eines DataSet-Objekts eine DataRelation hinzugefügt wird. Beim Hinzufügen einer solchen Beziehung werden automatisch eine UniqueConstraint und eine ForeignKeyConstraint erstellt, abhängig von den Parametereinstellungen für den Konstruktor. Die UniqueConstraint garantiert, dass die in einer Spalte enthaltenen Werte eindeutig sind. Die ForeignKeyConstraint bestimmt, welche Aktion beim Ändern oder Löschen eines Primärschlüsselwerts für die untergeordnete Zeile oder Spalte ausgeführt wird.
Mithilfe des System.Data.SqlClient-Namespaces (der .NET Framework-Datenanbieter für SQL Server), des System.Data.Odbc-Namespaces (der .NET Framework-Datenanbieter für ODBC), des System.Data.OleDb-Namespaces (der .NET Framework-Datenanbieter für OLE DB) oder des System.Data.OracleClient-Namespaces (der .NET Framework-Datenanbieter für Oracle) können Sie auf eine Datenquelle zur gemeinsamen Verwendung mit einem DataSet zugreifen. Jeder .NET Framework-Datenanbieter verfügt über einen entsprechenden DataAdapter, der als Brücke zwischen einer Datenquelle und einem DataSet verwendet wird.
Klassen
Klasse | Beschreibung | |
---|---|---|
Constraint | Stellt eine Einschränkung dar, die für ein oder mehrere DataColumn-Objekte erzwungen werden kann. | |
ConstraintCollection | Stellt eine Auflistung von Einschränkungen für eine DataTable dar. | |
ConstraintException | Stellt die Ausnahme dar, die ausgelöst wird, wenn das Ausführen einer Aktion versucht wird, durch die eine Einschränkung verletzt wird. | |
DataColumn | Stellt das Schema einer Spalte in einer DataTable dar. | |
DataColumnChangeEventArgs | Stellt Daten für das ColumnChanging-Ereignis bereit. | |
DataColumnCollection | Stellt eine Auflistung von DataColumn-Objekten für eine DataTable dar. | |
DataException | Stellt die Ausnahme dar, die ausgelöst wird, wenn Fehler bei der Verwendung von ADO.NET-Komponenten generiert werden. | |
DataRelation | Stellt eine Parent/Child-Beziehung zwischen zwei DataTable-Objekten dar. | |
DataRelationCollection | Stellt die Auflistung von DataRelation-Objekten für dieses DataSet dar. | |
DataRow | Stellt eine Datenzeile in einer DataTable dar. | |
DataRowBuilder | Der DataRowBuilder-Typ unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code ausgelegt. | |
DataRowChangeEventArgs | Stellt Daten für die folgenden Ereignisse bereit: RowChanged, RowChanging, OnRowDeleting und OnRowDeleted. | |
DataRowCollection | Stellt eine Auflistung von Zeilen für eine DataTable dar. | |
DataRowView | Stellt eine benutzerdefinierte Ansicht einer DataRow dar. | |
DataSet | Stellt einen Datencache im Arbeitsspeicher dar. | |
DataSetSchemaImporterExtension | Dieser Member unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code ausgelegt. | |
DataSysDescriptionAttribute | Kennzeichnet eine Eigenschaft, ein Ereignis oder einen Extender mit einer Beschreibung. In visuellen Designern kann diese Beschreibung beim Verweisen auf den Member angezeigt werden. | |
DataTable | Stellt eine Tabelle mit im Arbeitsspeicher befindlichen Daten dar. | |
DataTableClearEventArgs | Stellt Daten für die Clear-Methode bereit. | |
DataTableCollection | Stellt die Auflistung von Tabellen für das DataSet dar. | |
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ärtsresultsets ab. | |
DataView | Stellt eine datenbindungsfähige, angepasste Ansicht einer DataTable zum Sortieren, Filtern, Durchsuchen, Bearbeiten und Navigieren dar. | |
DataViewManager | Enthält eine Standard-DataViewSettingCollection für jede DataTable in einem DataSet. | |
DataViewSetting | Stellt die Standardeinstellungen für ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort und Table für DataViews dar, die vom DataViewManager erstellt wurden. | |
DataViewSettingCollection | Enthält eine schreibgeschützte Auflistung von DataViewSetting-Objekten für jede DataTable in einem DataSet. | |
DBConcurrencyException | Die Ausnahme, die vom DataAdapter während eines Einfügungs-, Aktualisierungs- oder Löschvorgangs ausgelöst wird, wenn die Anzahl der betroffenen Zeilen 0 (null) ist. | |
DeletedRowInaccessibleException | Stellt die Ausnahme dar, die bei dem Versuch ausgelöst wird, eine Aktion für eine gelöschte DataRow auszuführen. | |
DuplicateNameException | Stellt die Ausnahme dar, die ausgelöst wird, wenn während eines Hinzufügevorgangs in einem DataSet-bezogenen Objekt ein doppelter Datenbankobjektname auftritt. | |
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 einer DbDataAdapter-Klasse bereit. | |
ForeignKeyConstraint | Stellt eine Aktionsbeschränkung dar, die für eine Gruppe von Spalten in einer Primärschlüssel/Fremdschlüssel-Beziehung erzwungen wird, wenn ein Wert oder eine Spalte gelöscht oder aktualisiert wird. | |
InRowChangingEventException | Stellt die Ausnahme dar, die ausgelöst wird, wenn die EndEdit-Methode im RowChanging-Ereignis aufgerufen wird. | |
InternalDataCollectionBase | Stellt die Basisfunktionen für das Erstellen von Auflistungen bereit. | |
InvalidConstraintException | Stellt die Ausnahme dar, die bei einem fehlgeschlagenen Versuch ausgelöst wird, eine Beziehung zu erstellen oder auf eine Beziehung zuzugreifen. | |
InvalidExpressionException | Stellt die Ausnahme dar, die bei dem Versuch ausgelöst wird, einer DataColumnCollection eine DataColumn hinzuzufügen, die einen ungültigen Expression enthält. | |
MergeFailedEventArgs | Tritt ein, wenn eine Ziel- und eine Quell-DataRow denselben Primärschlüsselwert aufweisen und die EnforceConstraints-Eigenschaft auf True festgelegt ist. | |
MissingPrimaryKeyException | Stellt die Ausnahme dar, die beim Versuch ausgelöst wird, auf eine Zeile in einer Tabelle ohne Primärschlüssel zuzugreifen. | |
NoNullAllowedException | Stellt die Ausnahme dar, die bei dem Versuch ausgelöst wird, einen NULL-Wert in eine Spalte einzufügen, bei der AllowDBNull auf false festgelegt ist. | |
OperationAbortedException | Diese Ausnahme wird ausgelöst, wenn eine laufende Operation vom Benutzer abgebrochen wird. | |
PropertyCollection | Stellt eine Auflistung von Eigenschaften dar, die DataColumn, DataSet oder DataTable hinzugefügt werden können. | |
ReadOnlyException | Stellt die Ausnahme dar, die beim Versuch ausgelöst wird, den Wert einer schreibgeschützten Spalte zu ändern. | |
RowNotInTableException | Stellt die Ausnahme dar, die beim Versuch ausgelöst wird, eine Operation für eine DataRow auszuführen, die sich nicht in einer DataTable befindet. | |
StateChangeEventArgs | Stellt Daten für das Zustandsänderungsereignis eines .NET Framework-Datenproviders bereit. | |
StatementCompletedEventArgs | Stellt zusätzliche Informationen für das StatementCompleted-Ereignis bereit. | |
StrongTypingException | Die Ausnahme, die von einer stark typisierten DataSet-Klasse ausgelöst wird, wenn der Benutzer auf einen DBNull-Wert zugreift. | |
SyntaxErrorException | Stellt die Ausnahme dar, die ausgelöst wird, wenn die Expression-Eigenschaft einer DataColumn einen Syntaxfehler enthält. | |
TypedDataSetGenerator | Wird zum Erstellen einer stark typisierten DataSet-Klasse verwendet. | |
TypedDataSetGeneratorException | Die Ausnahme, die ausgelöst wird, wenn beim Generieren einer stark typisierten DataSet-Klasse ein Namenskonflikt auftritt. | |
UniqueConstraint | Stellt eine Einschränkung für eine Gruppe von Spalten dar, bei der alle Werte eindeutig sein müssen. | |
VersionNotFoundException | Stellt die Ausnahme dar, die bei dem Versuch ausgelöst wird, eine Version einer gelöschten DataRow zurückzugeben. |
Schnittstellen
Schnittstelle | Beschreibung | |
---|---|---|
IColumnMapping | Ordnet einer DataSet-Spalte eine Spalte einer Datenquelle zu und wird von der DataColumnMapping-Klasse implementiert, die von allen .NET Framework-Datenanbietern gemeinsam verwendet wird. | |
IColumnMappingCollection | Enthält eine Auflistung von DataColumnMapping-Objekten und wird durch die DataColumnMappingCollection implementiert, die von allen .NET Framework-Datenanbietern gemeinsam verwendet wird. | |
IDataAdapter | Ermöglicht einem Objekt das Implementieren eines DataAdapter und stellt eine Gruppe von Methoden und zuordnungsbezogenen Eigenschaften dar, mit denen ein DataSet gefüllt und aktualisiert sowie eine Datenquelle aktualisiert wird. | |
IDataParameter | Stellt einen Parameter für ein Command-Objekt sowie optional dessen Zuordnung zu DataSet-Spalten dar und wird durch .NET Framework-Datenanbieter implementiert, die auf Datenquellen zugreifen. | |
IDataParameterCollection | Listet alle für ein Command-Objekt relevanten Parameter sowie ihre Zuordnungen zu DataSet-Spalten auf und wird von .NET Framework-Datenanbietern implementiert, die auf Datenquellen zugreifen. | |
IDataReader | Stellt ein Verfahren zum Lesen eines oder mehrerer Vorwärtsstreams von Resultsets bereit, die durch Ausführen eines Befehls an einer Datenquelle erhalten wurden, und wird durch .NET Framework-Datenprovider implementiert, die auf relationale Datenbanken zugreifen. | |
IDataRecord | Ermöglicht den Zugriff auf die Spaltenwerte in den einzelnen Zeilen für einen DataReader und wird durch .NET Framework-Datenprovider implementiert, die auf relationale Datenbanken zugreifen. | |
IDbCommand | Stellt eine SQL-Anweisung dar, die während einer Verbindung mit einer Datenquelle ausgeführt wird. Die Implementierung erfolgt durch .NET Framework-Datenprovider, die auf relationale Datenbanken zugreifen. | |
IDbConnection | Stellt eine geöffnete Verbindung mit einer Datenquelle dar und wird von .NET Framework-Datenprovidern implementiert, die auf relationale Datenbanken zugreifen. | |
IDbDataAdapter | Stellt eine Gruppe von befehlsbezogenen Eigenschaften dar, die zum Auffüllen des DataSet und zum Aktualisieren einer Datenquelle verwendet werden. Die Implementierung erfolgt durch .NET Framework-Datenanbieter, die auf relationale Datenbanken zugreifen. | |
IDbDataParameter | Wird von den Visual Basic-.NET-Daten-Designern zum Darstellen eines Parameters für ein Command-Objekt und optional zum Darstellen seiner Zuordnung zu DataSet-Spalten verwendet. | |
IDbTransaction | Stellt eine für eine Datenquelle auszuführende Transaktion dar und wird von .NET Framework-Datenprovidern implementiert, die auf relationale Datenbanken zugreifen. | |
ITableMapping | Ordnet einer Tabelle in einer DataSet-Klasse eine Quelltabelle zu und wird von der DataTableMapping-Klasse implementiert, die von .NET Framework-Datenanbietern gemeinsam verwendet wird. | |
ITableMappingCollection | Enthält eine Auflistung von TableMapping-Objekten und wird durch die DataTableMappingCollection-Klasse implementiert, die von .NET Framework-Datenanbietern gemeinsam verwendet wird. |
Delegaten
Delegat | Beschreibung | |
---|---|---|
DataColumnChangeEventHandler | Stellt die Methode dar, die das ColumnChanging-Ereignis behandelt. | |
DataRowChangeEventHandler | Stellt die Methode dar, die die folgenden Ereignisse einer DataTable behandelt:RowChanging, RowChanged, RowDeleting und RowDeleted. | |
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. |
Enumerationen
Enumeration | Beschreibung | |
---|---|---|
AcceptRejectRule | Bestimmt die Aktion, die ausgeführt wird, wenn die AcceptChanges-Methode oder die RejectChanges-Methode für eine DataTable mit einer ForeignKeyConstraint aufgerufen wird. | |
CommandBehavior | Stellt eine Beschreibung der Ergebnisse der Abfrage sowie ihrer Auswirkungen auf die Datenbank bereit. | |
CommandType | Gibt an, wie eine Befehlszeichenfolge interpretiert wird. | |
ConflictOption | Gibt an, wie Konflikte verursachende Ä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 DataRow ausgeführt wird. | |
DataRowState | Ruft den Zustand eines DataRow-Objekts ab. | |
DataRowVersion | Beschreibt die Version einer DataRow-Klasse. | |
DataSetDateTime | Beschreibt das Serialisierungsformat für DateTime-Spalten in einem DataSet. | |
DataViewRowState | Beschreibt die Version der Daten in einer DataRow-Klasse. | |
DbType | Gibt den Datentyp eines Felds, einer Eigenschaft oder eines Parameter-Objekts eines .NET Framework-Datenproviders an. | |
IsolationLevel | Gibt das Sperrverhalten für Transaktionen für die Verbindung an. | |
KeyRestrictionBehavior | Bezeichnet eine Liste von durch die KeyRestrictions-Eigenschaft angegebenen Parametern für Verbindungszeichenfolgen, die zulässig oder nicht zulässig sind. | |
LoadOption | Steuert das Anwenden von Werten der Datenquelle auf vorhandene Zeilen bei Verwendung der Load-Methode oder der Load-Methode. | |
MappingType | Gibt an, wie eine DataColumn zugeordnet wird. | |
MissingMappingAction | Bestimmt die Aktion, die ausgeführt wird, wenn für eine Quelltabelle oder eine Quellspalte eine Zuordnung fehlt. | |
MissingSchemaAction | Gibt an, welche Aktion ausgeführt werden soll, wenn der DataSet-Klasse Daten hinzugefügt werden und die erforderliche DataTable-Klasse bzw. DataColumn-Klasse nicht vorhanden ist. | |
ParameterDirection | Gibt den Typ eines Parameters in einer Abfrage relativ zum DataSet an. | |
PropertyAttributes | Gibt die Attribute einer Eigenschaft an. | |
Rule | Gibt die Aktion an, die beim Erzwingen einer ForeignKeyConstraint-Klasse ausgeführt wird. | |
SchemaSerializationMode | Gibt den Schemaserialisierungsmodus für ein typisiertes DataSet an. | |
SchemaType | Gibt an, wie vorhandene Schemazuordnungen beim Durchführen einer FillSchema-Operation behandelt werden sollen. | |
SerializationFormat | Bestimmt das Serialisierungsformat für ein DataSet. | |
SqlDbType | Gibt den SQL Server-Datentyp eines Felds oder einer Eigenschaft zur Verwendung in einem SqlParameter an. | |
StatementType | Gibt den Typ der SQL-Abfrage an, der von einer der folgenden Klassen verwendet werden soll: OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgs oder SqlRowUpdatingEventArgs. | |
UpdateRowSource | Gibt an, wie Ergebnisse von Abfragebefehlen auf die aktualisierte Zeile angewendet werden. | |
UpdateStatus | Gibt die Aktion an, die während der Ausführung eines Update für die aktuelle Zeile und für die restlichen Zeilen ausgeführt werden soll. | |
XmlReadMode | Gibt an, wie XML-Daten und ein relationales Schema in ein DataSet eingelesen werden sollen. | |
XmlWriteMode | Gibt an, wie XML-Daten und ein relationales Schema aus einer DataSet-Klasse geschrieben werden sollen. |