Freigeben über


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
Öffentliche Klasse Constraint Stellt eine Einschränkung dar, die für ein oder mehrere DataColumn-Objekte erzwungen werden kann.
Öffentliche Klasse ConstraintCollection Stellt eine Auflistung von Einschränkungen für eine DataTable dar.
Öffentliche Klasse ConstraintException Stellt die Ausnahme dar, die ausgelöst wird, wenn das Ausführen einer Aktion versucht wird, durch die eine Einschränkung verletzt wird.
Öffentliche Klasse DataColumn Stellt das Schema einer Spalte in einer DataTable dar.
Öffentliche Klasse DataColumnChangeEventArgs Stellt Daten für das ColumnChanging-Ereignis bereit.
Öffentliche Klasse DataColumnCollection Stellt eine Auflistung von DataColumn-Objekten für eine DataTable dar.
Öffentliche Klasse DataException Stellt die Ausnahme dar, die ausgelöst wird, wenn Fehler bei der Verwendung von ADO.NET-Komponenten generiert werden.
Öffentliche Klasse DataRelation Stellt eine Parent/Child-Beziehung zwischen zwei DataTable-Objekten dar.
Öffentliche Klasse DataRelationCollection Stellt die Auflistung von DataRelation-Objekten für dieses DataSet dar.
Öffentliche Klasse DataRow Stellt eine Datenzeile in einer DataTable dar.
Öffentliche Klasse DataRowBuilder Der DataRowBuilder-Typ unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code ausgelegt.
Öffentliche Klasse DataRowChangeEventArgs Stellt Daten für die folgenden Ereignisse bereit: RowChanged, RowChanging, OnRowDeleting und OnRowDeleted.
Öffentliche Klasse DataRowCollection Stellt eine Auflistung von Zeilen für eine DataTable dar.
Öffentliche Klasse DataRowView Stellt eine benutzerdefinierte Ansicht einer DataRow dar.
Öffentliche Klasse DataSet Stellt einen Datencache im Arbeitsspeicher dar.
Öffentliche Klasse DataSetSchemaImporterExtension Dieser Member unterstützt die .NET Framework-Infrastruktur und ist nicht für die direkte Verwendung in Code ausgelegt.
Öffentliche Klasse 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.
Öffentliche Klasse DataTable Stellt eine Tabelle mit im Arbeitsspeicher befindlichen Daten dar.
Öffentliche Klasse DataTableClearEventArgs Stellt Daten für die Clear-Methode bereit.
Öffentliche Klasse DataTableCollection Stellt die Auflistung von Tabellen für das DataSet dar.
Öffentliche Klasse DataTableNewRowEventArgs Stellt Daten für die NewRow-Methode bereit.
Öffentliche Klasse DataTableReader Der DataTableReader ruft den Inhalt eines oder mehrerer DataTable-Objekte in Form eines oder mehrerer schreibgeschützter Vorwärtsresultsets ab.
Öffentliche Klasse DataView Stellt eine datenbindungsfähige, angepasste Ansicht einer DataTable zum Sortieren, Filtern, Durchsuchen, Bearbeiten und Navigieren dar.
Öffentliche Klasse DataViewManager Enthält eine Standard-DataViewSettingCollection für jede DataTable in einem DataSet.
Öffentliche Klasse DataViewSetting Stellt die Standardeinstellungen für ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort und Table für DataViews dar, die vom DataViewManager erstellt wurden.
Öffentliche Klasse DataViewSettingCollection Enthält eine schreibgeschützte Auflistung von DataViewSetting-Objekten für jede DataTable in einem DataSet.
Öffentliche Klasse 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.
Öffentliche Klasse DeletedRowInaccessibleException Stellt die Ausnahme dar, die bei dem Versuch ausgelöst wird, eine Aktion für eine gelöschte DataRow auszuführen.
Öffentliche Klasse DuplicateNameException Stellt die Ausnahme dar, die ausgelöst wird, wenn während eines Hinzufügevorgangs in einem DataSet-bezogenen Objekt ein doppelter Datenbankobjektname auftritt.
Öffentliche Klasse EvaluateException Stellt die Ausnahme dar, die ausgelöst wird, wenn die Expression-Eigenschaft einer DataColumn nicht ausgewertet werden kann.
Öffentliche Klasse FillErrorEventArgs Stellt Daten für das FillError-Ereignis einer DbDataAdapter-Klasse bereit.
Öffentliche Klasse 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.
Öffentliche Klasse InRowChangingEventException Stellt die Ausnahme dar, die ausgelöst wird, wenn die EndEdit-Methode im RowChanging-Ereignis aufgerufen wird.
Öffentliche Klasse InternalDataCollectionBase Stellt die Basisfunktionen für das Erstellen von Auflistungen bereit.
Öffentliche Klasse InvalidConstraintException Stellt die Ausnahme dar, die bei einem fehlgeschlagenen Versuch ausgelöst wird, eine Beziehung zu erstellen oder auf eine Beziehung zuzugreifen.
Öffentliche Klasse 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.
Öffentliche Klasse MergeFailedEventArgs Tritt ein, wenn eine Ziel- und eine Quell-DataRow denselben Primärschlüsselwert aufweisen und die EnforceConstraints-Eigenschaft auf True festgelegt ist.
Öffentliche Klasse MissingPrimaryKeyException Stellt die Ausnahme dar, die beim Versuch ausgelöst wird, auf eine Zeile in einer Tabelle ohne Primärschlüssel zuzugreifen.
Öffentliche Klasse 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.
Öffentliche Klasse OperationAbortedException Diese Ausnahme wird ausgelöst, wenn eine laufende Operation vom Benutzer abgebrochen wird.
Öffentliche Klasse PropertyCollection Stellt eine Auflistung von Eigenschaften dar, die DataColumn, DataSet oder DataTable hinzugefügt werden können.
Öffentliche Klasse ReadOnlyException Stellt die Ausnahme dar, die beim Versuch ausgelöst wird, den Wert einer schreibgeschützten Spalte zu ändern.
Öffentliche Klasse 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.
Öffentliche Klasse StateChangeEventArgs Stellt Daten für das Zustandsänderungsereignis eines .NET Framework-Datenproviders bereit.
Öffentliche Klasse StatementCompletedEventArgs Stellt zusätzliche Informationen für das StatementCompleted-Ereignis bereit.
Öffentliche Klasse StrongTypingException Die Ausnahme, die von einer stark typisierten DataSet-Klasse ausgelöst wird, wenn der Benutzer auf einen DBNull-Wert zugreift.
Öffentliche Klasse SyntaxErrorException Stellt die Ausnahme dar, die ausgelöst wird, wenn die Expression-Eigenschaft einer DataColumn einen Syntaxfehler enthält.
Öffentliche Klasse TypedDataSetGenerator Wird zum Erstellen einer stark typisierten DataSet-Klasse verwendet.
Öffentliche Klasse TypedDataSetGeneratorException Die Ausnahme, die ausgelöst wird, wenn beim Generieren einer stark typisierten DataSet-Klasse ein Namenskonflikt auftritt.
Öffentliche Klasse UniqueConstraint Stellt eine Einschränkung für eine Gruppe von Spalten dar, bei der alle Werte eindeutig sein müssen.
Öffentliche Klasse VersionNotFoundException Stellt die Ausnahme dar, die bei dem Versuch ausgelöst wird, eine Version einer gelöschten DataRow zurückzugeben.

Schnittstellen

  Schnittstelle Beschreibung
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle IColumnMappingCollection Enthält eine Auflistung von DataColumnMapping-Objekten und wird durch die DataColumnMappingCollection implementiert, die von allen .NET Framework-Datenanbietern gemeinsam verwendet wird.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle IDbConnection Stellt eine geöffnete Verbindung mit einer Datenquelle dar und wird von .NET Framework-Datenprovidern implementiert, die auf relationale Datenbanken zugreifen.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle IDbTransaction Stellt eine für eine Datenquelle auszuführende Transaktion dar und wird von .NET Framework-Datenprovidern implementiert, die auf relationale Datenbanken zugreifen.
Öffentliche Schnittstelle 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.
Öffentliche Schnittstelle 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
Öffentlicher Delegat DataColumnChangeEventHandler Stellt die Methode dar, die das ColumnChanging-Ereignis behandelt.
Öffentlicher Delegat DataRowChangeEventHandler Stellt die Methode dar, die die folgenden Ereignisse einer DataTable behandelt:RowChanging, RowChanged, RowDeleting und RowDeleted.
Öffentlicher Delegat DataTableClearEventHandler Stellt die Methode dar, die die Clear-Methode behandelt.
Öffentlicher Delegat DataTableNewRowEventHandler Stellt die Methode dar, die die NewRow-Methode behandelt.
Öffentlicher Delegat FillErrorEventHandler Stellt die Methode dar, die das FillError-Ereignis behandelt.
Öffentlicher Delegat MergeFailedEventHandler Stellt die Methode dar, die das MergeFailed-Ereignis behandelt.
Öffentlicher Delegat StateChangeEventHandler Stellt die Methode dar, die das StateChange-Ereignis behandelt.
Öffentlicher Delegat StatementCompletedEventHandler Der Delegattyp für die Ereignishandler des StatementCompleted-Ereignisses.

Enumerationen

  Enumeration Beschreibung
Öffentliche Enumeration 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.
Öffentliche Enumeration CommandBehavior Stellt eine Beschreibung der Ergebnisse der Abfrage sowie ihrer Auswirkungen auf die Datenbank bereit.
Öffentliche Enumeration CommandType Gibt an, wie eine Befehlszeichenfolge interpretiert wird.
Öffentliche Enumeration ConflictOption Gibt an, wie Konflikte verursachende Änderungen an der Datenquelle erkannt und aufgelöst werden.
Öffentliche Enumeration ConnectionState Beschreibt den aktuellen Zustand der Verbindung mit einer Datenquelle.
Öffentliche Enumeration DataRowAction Beschreibt eine Aktion, die für eine DataRow ausgeführt wird.
Öffentliche Enumeration DataRowState Ruft den Zustand eines DataRow-Objekts ab.
Öffentliche Enumeration DataRowVersion Beschreibt die Version einer DataRow-Klasse.
Öffentliche Enumeration DataSetDateTime Beschreibt das Serialisierungsformat für DateTime-Spalten in einem DataSet.
Öffentliche Enumeration DataViewRowState Beschreibt die Version der Daten in einer DataRow-Klasse.
Öffentliche Enumeration DbType Gibt den Datentyp eines Felds, einer Eigenschaft oder eines Parameter-Objekts eines .NET Framework-Datenproviders an.
Öffentliche Enumeration IsolationLevel Gibt das Sperrverhalten für Transaktionen für die Verbindung an.
Öffentliche Enumeration KeyRestrictionBehavior Bezeichnet eine Liste von durch die KeyRestrictions-Eigenschaft angegebenen Parametern für Verbindungszeichenfolgen, die zulässig oder nicht zulässig sind.
Öffentliche Enumeration LoadOption Steuert das Anwenden von Werten der Datenquelle auf vorhandene Zeilen bei Verwendung der Load-Methode oder der Load-Methode.
Öffentliche Enumeration MappingType Gibt an, wie eine DataColumn zugeordnet wird.
Öffentliche Enumeration MissingMappingAction Bestimmt die Aktion, die ausgeführt wird, wenn für eine Quelltabelle oder eine Quellspalte eine Zuordnung fehlt.
Öffentliche Enumeration 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.
Öffentliche Enumeration ParameterDirection Gibt den Typ eines Parameters in einer Abfrage relativ zum DataSet an.
Öffentliche Enumeration PropertyAttributes Gibt die Attribute einer Eigenschaft an.
Öffentliche Enumeration Rule Gibt die Aktion an, die beim Erzwingen einer ForeignKeyConstraint-Klasse ausgeführt wird.
Öffentliche Enumeration SchemaSerializationMode Gibt den Schemaserialisierungsmodus für ein typisiertes DataSet an.
Öffentliche Enumeration SchemaType Gibt an, wie vorhandene Schemazuordnungen beim Durchführen einer FillSchema-Operation behandelt werden sollen.
Öffentliche Enumeration SerializationFormat Bestimmt das Serialisierungsformat für ein DataSet.
Öffentliche Enumeration SqlDbType Gibt den SQL Server-Datentyp eines Felds oder einer Eigenschaft zur Verwendung in einem SqlParameter an.
Öffentliche Enumeration StatementType Gibt den Typ der SQL-Abfrage an, der von einer der folgenden Klassen verwendet werden soll: OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgs oder SqlRowUpdatingEventArgs.
Öffentliche Enumeration UpdateRowSource Gibt an, wie Ergebnisse von Abfragebefehlen auf die aktualisierte Zeile angewendet werden.
Öffentliche Enumeration 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.
Öffentliche Enumeration XmlReadMode Gibt an, wie XML-Daten und ein relationales Schema in ein DataSet eingelesen werden sollen.
Öffentliche Enumeration XmlWriteMode Gibt an, wie XML-Daten und ein relationales Schema aus einer DataSet-Klasse geschrieben werden sollen.