System.Data Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| EntityState |
Der Status eines Entitätsobjekts. |
| IsolationLevel |
Gibt das Transaktionssperrverhalten für die Verbindung an. |
| KeyRestrictionBehavior |
Identifiziert eine Liste von Verbindungszeichenfolgenparametern, die durch die |
| 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.