Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
1 von 1 fanden dies hilfreich - Dieses Thema bewerten.

DataTable-Klasse

Stellt eine Tabelle mit speicherinternen Daten dar.

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)
[SerializableAttribute]
public class DataTable : MarshalByValueComponent, IListSource, 
	ISupportInitializeNotification, ISupportInitialize, ISerializable, IXmlSerializable

Der DataTable-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkDataTable()Initialisiert eine neue Instanz der DataTable-Klasse ohne Argumente.
Öffentliche MethodeUnterstützt von XNA FrameworkDataTable(String)Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen.
Geschützte MethodeDataTable(SerializationInfo, StreamingContext)Initialisiert eine neue Instanz der DataTable-Klasse mit der SerializationInfo und dem StreamingContext.
Öffentliche MethodeUnterstützt von XNA FrameworkDataTable(String, String)Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen und Namespace.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftUnterstützt von XNA FrameworkCaseSensitiveGibt an, ob Vergleiche zwischen Zeichenfolgen in der Tabelle unter Berücksichtigung der Groß- und Kleinschreibung ausgeführt werden.
Öffentliche EigenschaftUnterstützt von XNA FrameworkChildRelationsRuft die Auflistung untergeordneter Beziehungen für diese DataTable ab.
Öffentliche EigenschaftUnterstützt von XNA FrameworkColumnsRuft die Auflistung der Spalten ab, die zu dieser Tabelle gehören.
Öffentliche EigenschaftUnterstützt von XNA FrameworkConstraintsRuft die Auflistung der Einschränkungen ab, die von dieser Tabelle verwaltet werden.
Öffentliche EigenschaftUnterstützt von XNA FrameworkContainerRuft den Container für die Komponente ab. (Von MarshalByValueComponent geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkDataSetRuft das DataSet ab, zu dem diese Tabelle gehört.
Öffentliche EigenschaftUnterstützt von XNA FrameworkDefaultViewRuft eine benutzerdefinierte Sicht der Tabelle ab, wobei es sich um eine gefilterte Sicht oder eine Cursorposition handeln kann.
Öffentliche EigenschaftUnterstützt von XNA FrameworkDesignModeRuft einen Wert ab, der angibt, ob sich die Komponente gegenwärtig im Entwurfsmodus befindet. (Von MarshalByValueComponent geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkDisplayExpressionRuft den Ausdruck ab, der einen Wert für die Darstellung dieser Tabelle auf der Benutzeroberfläche zurückgibt, oder legt diesen fest. Mit der DisplayExpression-Eigenschaft können Sie den Namen dieser Tabelle auf einer Benutzeroberfläche anzeigen.
Geschützte EigenschaftUnterstützt von XNA FrameworkEventsRuft die Liste der an diese Komponente angefügten Ereignishandler ab. (Von MarshalByValueComponent geerbt.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkExtendedPropertiesRuft die Auflistung benutzerdefinierter Benutzerinformationen ab.
Öffentliche EigenschaftUnterstützt von XNA FrameworkHasErrorsRuft einen Wert ab, der angibt, ob in einer Zeile in einer Tabelle des DataSet, zu dem die Tabelle gehört, Fehler aufgetreten sind.
Öffentliche EigenschaftUnterstützt von XNA FrameworkIsInitializedRuft einen Wert ab, der angibt, ob die DataTable initialisiert wurde.
Öffentliche EigenschaftUnterstützt von XNA FrameworkLocaleRuft die Gebietsschemainformationen ab, die für den Vergleich von Zeichenfolgen in der Tabelle verwendet werden, oder legt diese fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkMinimumCapacityRuft die Ausgangsgröße für diese Tabelle ab oder legt diese fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkNamespaceRuft den Namespace für die XML-Darstellung der in der DataTable gespeicherten Daten ab oder legt diesen fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkParentRelationsRuft die Auflistung übergeordneter Beziehungen für diese DataTable ab.
Öffentliche EigenschaftUnterstützt von XNA FrameworkPrefixRuft den Namespace für die XML-Darstellung der in der DataTable gespeicherten Daten ab oder legt diesen fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkPrimaryKeyRuft ein Array von Spalten ab, die als Primärschlüssel für die Datentabelle verwendet werden, oder legt dieses fest.
Öffentliche EigenschaftRemotingFormatRuft das Serialisierungsformat ab oder legt dieses fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkRowsRuft die Auflistung der Zeilen ab, die zu dieser Tabelle gehören.
Öffentliche EigenschaftUnterstützt von XNA FrameworkSiteRuft eine System.ComponentModel.ISite für die DataTable ab oder legt diese fest. (Überschreibt MarshalByValueComponent.Site.)
Öffentliche EigenschaftUnterstützt von XNA FrameworkTableNameRuft den Namen der DataTable ab oder legt diesen fest.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkAcceptChangesÜbernimmt alle Änderungen, die an dieser Tabelle seit dem letzten Aufruf von AcceptChanges vorgenommen wurden.
Öffentliche MethodeUnterstützt von XNA FrameworkBeginInitBeginnt die Initialisierung einer DataTable, die in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit.
Öffentliche MethodeUnterstützt von XNA FrameworkBeginLoadDataDeaktiviert während des Ladens von Daten Benachrichtigungen, Indexverwaltung und Einschränkungen.
Öffentliche MethodeUnterstützt von XNA FrameworkClearLöscht alle Daten aus der DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkCloneKlont die Struktur der DataTable, einschließlich aller Schemas und Einschränkungen der DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkComputeBerechnet den angegebenen Ausdruck für die aktuellen Zeilen, die die Filterkriterien erfüllen.
Öffentliche MethodeUnterstützt von XNA FrameworkCopyKopiert die Struktur und die Daten für diese DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkCreateDataReaderGibt einen DataTableReader zurück, der den Daten innerhalb dieser DataTable entspricht.
Geschützte MethodeUnterstützt von XNA FrameworkCreateInstanceInfrastruktur. Erstellt eine neue Instanz von DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkDispose()Gibt alle vom MarshalByValueComponent verwendeten Ressourcen frei. (Von MarshalByValueComponent geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkDispose(Boolean)Gibt die von MarshalByValueComponent verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Von MarshalByValueComponent geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkEndInitBeendet die Initialisierung einer DataTable, die in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit.
Öffentliche MethodeUnterstützt von XNA FrameworkEndLoadDataAktiviert nach dem Laden von Daten Benachrichtigungen, Indexverwaltung und Einschränkungen.
Öffentliche MethodeUnterstützt von XNA FrameworkEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeUnterstützt von XNA FrameworkFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von MarshalByValueComponent geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetChanges()Ruft eine Kopie der DataTable ab, die alle seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommenen Änderungen enthält.
Öffentliche MethodeUnterstützt von XNA FrameworkGetChanges(DataRowState)Ruft eine Kopie der DataTable ab, die alle seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommenen und durch DataRowState gefilterten Änderungen enthält.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkGetDataTableSchemaDiese Methode gibt eine XmlSchemaSet-Instanz mit der WSDL (Web Services Description Language) zurück, die die DataTable für Webdienste beschreibt.
Öffentliche MethodeUnterstützt von XNA FrameworkGetErrorsRuft ein Array von DataRow-Objekten ab, die Fehler enthalten.
Öffentliche MethodeUnterstützt von XNA FrameworkGetHashCodeFungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche MethodeGetObjectDataFüllt ein Serialisierungsinformationsobjekt mit den Daten, die zum Serialisieren des DataTable erforderlich sind.
Geschützte MethodeUnterstützt von XNA FrameworkGetRowTypeInfrastruktur. Ruft den Zeilentyp ab.
Geschützte MethodeUnterstützt von XNA FrameworkGetSchemaInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.GetSchema.
Öffentliche MethodeUnterstützt von XNA FrameworkGetServiceRuft die Implementierung von IServiceProvider ab. (Von MarshalByValueComponent geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkImportRowKopiert eine DataRow in eine DataTable, wobei alle Eigenschafteneinstellungen sowie die ursprünglichen und die aktuellen Werte beibehalten werden.
Öffentliche MethodeUnterstützt von XNA FrameworkLoad(IDataReader)Füllt eine DataTable mit Werten aus einer Datenquelle, die den angegebenen IDataReader verwendet. Wenn die DataTable bereits Zeilen enthält, werden die eingehenden Daten aus der Datenquelle mit den vorhandenen Zeilen zusammengeführt.
Öffentliche MethodeUnterstützt von XNA FrameworkLoad(IDataReader, LoadOption)Füllt eine DataTable mit Werten aus einer Datenquelle, die den angegebenen IDataReader verwendet. Wenn die DataTable bereits Zeilen enthält, werden die eingehenden Daten gemäß dem Wert des loadOption-Parameters aus der Datenquelle mit den vorhandenen Zeilen zusammengeführt.
Öffentliche MethodeUnterstützt von XNA FrameworkLoad(IDataReader, LoadOption, FillErrorEventHandler)Füllt eine DataTable mit Werten aus einer Datenquelle mit dem bereitgestellten IDataReader und unter Verwendung eines Fehlerbehandlungsdelegaten.
Öffentliche MethodeUnterstützt von XNA FrameworkLoadDataRow(Object[], Boolean)Sucht eine bestimmte Zeile und aktualisiert diese. Wenn keine übereinstimmende Zeile gefunden werden kann, wird eine neue Zeile mit den angegebenen Werten erstellt.
Öffentliche MethodeUnterstützt von XNA FrameworkLoadDataRow(Object[], LoadOption)Sucht eine bestimmte Zeile und aktualisiert diese. Wenn keine übereinstimmende Zeile gefunden werden kann, wird eine neue Zeile mit den angegebenen Werten erstellt.
Geschützte MethodeUnterstützt von XNA FrameworkMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkMerge(DataTable)Führen Sie die angegebene DataTable mit der aktuellen DataTable zusammen.
Öffentliche MethodeUnterstützt von XNA FrameworkMerge(DataTable, Boolean)Führen Sie die angegebene DataTable mit der aktuellen DataTable zusammen, und geben Sie an, ob die Änderungen in der aktuellen DataTable beibehalten werden sollen.
Öffentliche MethodeUnterstützt von XNA FrameworkMerge(DataTable, Boolean, MissingSchemaAction)Führen Sie die angegebene DataTable mit der aktuellen DataTable zusammen, und geben Sie an, ob die Änderungen in der aktuellen DataTable beibehalten werden sollen und wie das fehlende Schema behandelt werden soll.
Öffentliche MethodeUnterstützt von XNA FrameworkNewRowErstellt eine neue DataRow mit dem Schema der Tabelle.
Geschützte MethodeUnterstützt von XNA FrameworkNewRowArrayInfrastruktur. Gibt ein DataRow-Array zurück.
Geschützte MethodeUnterstützt von XNA FrameworkNewRowFromBuilderErstellt eine neue Zeile aus einer vorhandenen Zeile.
Geschützte MethodeUnterstützt von XNA FrameworkOnColumnChangedLöst das ColumnChanged-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnColumnChangingLöst das ColumnChanging-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnPropertyChangingLöst das PropertyChanged-Ereignis aus.
Geschützte MethodeOnRemoveColumnBenachrichtigt die DataTable, dass eine DataColumn entfernt wird.
Geschützte MethodeUnterstützt von XNA FrameworkOnRowChangedLöst das RowChanged-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnRowChangingLöst das RowChanging-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnRowDeletedLöst das RowDeleted-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnRowDeletingLöst das RowDeleting-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnTableClearedLöst das TableCleared-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnTableClearingLöst das TableClearing-Ereignis aus.
Geschützte MethodeUnterstützt von XNA FrameworkOnTableNewRowLöst das TableNewRow-Ereignis aus.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXml(Stream)Liest mit dem angegebenen Stream das XML-Schema und die XML-Daten in die DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXml(String)Liest das XML-Schema und die XML-Daten in die DataTable aus der angegebenen Datei.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXml(TextReader)Liest mit dem angegebenen TextReader das XML-Schema und die XML-Daten in die DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXml(XmlReader)Liest das XML-Schema und die XML-Daten mit dem angegebenen XmlReader in die DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXmlSchema(Stream)Liest ein XML-Schema mit dem angegebenen Stream in die DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXmlSchema(String)Liest ein XML-Schema aus der angegebenen Datei in die DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXmlSchema(TextReader)Liest ein XML-Schema mit dem angegebenen TextReader in die DataTable.
Öffentliche MethodeUnterstützt von XNA FrameworkReadXmlSchema(XmlReader)Liest ein XML-Schema mit dem angegebenen XmlReader in die DataTable.
Geschützte MethodeUnterstützt von XNA FrameworkReadXmlSerializableInfrastruktur. Liest aus einem XML-Stream.
Öffentliche MethodeUnterstützt von XNA FrameworkRejectChangesFührt einen Rollback aller Änderungen durch, die an der Tabelle seit dem Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommen wurden.
Öffentliche MethodeUnterstützt von XNA FrameworkResetSetzt die DataTable auf den ursprünglichen Zustand zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkSelect()Ruft ein Array aller DataRow-Objekte ab.
Öffentliche MethodeUnterstützt von XNA FrameworkSelect(String)Ruft ein Array aller DataRow-Objekte ab, die den Filterkriterien entsprechen.
Öffentliche MethodeUnterstützt von XNA FrameworkSelect(String, String)Ruft ein Array aller DataRow-Objekte, die die Filterkriterien erfüllen, in der angegebenen Sortierreihenfolge ab.
Öffentliche MethodeUnterstützt von XNA FrameworkSelect(String, String, DataViewRowState)Ruft ein Array aller DataRow-Objekte ab, die die Filterkriterien in der Sortierreihenfolge erfüllen und zum angegebenen Zustand passen.
Öffentliche MethodeUnterstützt von XNA FrameworkToStringRuft den TableName und den DisplayExpression, sofern vorhanden, als verkettete Zeichenfolge ab. (Überschreibt MarshalByValueComponent.ToString().)
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(Stream)Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen Stream.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(String)Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(TextWriter)Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen TextWriter.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(XmlWriter)Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen XmlWriter.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(Stream, Boolean)Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen Stream. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(Stream, XmlWriteMode)Schreibt im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(String, Boolean)Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(String, XmlWriteMode)Schreibt mit der angegebenen Datei und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(TextWriter, Boolean)Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen TextWriter. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(TextWriter, XmlWriteMode)Schreibt mit dem angegebenen TextWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(XmlWriter, Boolean)Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen XmlWriter.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(XmlWriter, XmlWriteMode)Schreibt mit dem angegebenen XmlWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(Stream, XmlWriteMode, Boolean)Schreibt im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable in die angegebene Datei. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(String, XmlWriteMode, Boolean)Schreibt mit der angegebenen Datei und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für das DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(TextWriter, XmlWriteMode, Boolean)Schreibt mit dem angegebenen TextWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXml(XmlWriter, XmlWriteMode, Boolean)Schreibt mit dem angegebenen XmlWriter und im angegebenen XmlWriteMode die aktuellen Daten und bei Bedarf das Schema für die DataTable. Um das Schema zu schreiben, legen Sie den Wert für den mode-Parameter auf WriteSchema fest. Legen Sie zum Speichern der Daten für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(Stream)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in den angegebenen Stream.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(String)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in die angegebene Datei.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(TextWriter)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen TextWriter.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(XmlWriter)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen XmlWriter.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(Stream, Boolean)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in den angegebenen Stream. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(String, Boolean)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in die angegebene Datei. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(TextWriter, Boolean)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen TextWriter. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Öffentliche MethodeUnterstützt von XNA FrameworkWriteXmlSchema(XmlWriter, Boolean)Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen XmlWriter. Legen Sie zum Speichern des Schemas für die Tabelle und ihre Nachfolgerelemente den writeHierarchy-Parameter auf true fest.
Zum Seitenanfang
  NameBeschreibung
Öffentliches EreignisUnterstützt von XNA FrameworkColumnChangedTritt ein, nachdem ein Wert für die angegebene DataColumn in einer DataRow geändert wurde.
Öffentliches EreignisUnterstützt von XNA FrameworkColumnChangingTritt ein, wenn ein Wert für die angegebene DataColumn in einer DataRow geändert wird.
Öffentliches EreignisUnterstützt von XNA FrameworkDisposedFügt einen Ereignishandler hinzu, der das Disposed-Ereignis für die Komponente überwacht. (Von MarshalByValueComponent geerbt.)
Öffentliches EreignisUnterstützt von XNA FrameworkInitializedTritt nach dem Initialisieren der DataTable auf.
Öffentliches EreignisUnterstützt von XNA FrameworkRowChangedTritt ein, nachdem eine DataRow erfolgreich geändert wurde.
Öffentliches EreignisUnterstützt von XNA FrameworkRowChangingTritt ein, wenn eine DataRow geändert wird.
Öffentliches EreignisUnterstützt von XNA FrameworkRowDeletedTritt ein, nachdem eine Zeile in der Tabelle gelöscht wurde.
Öffentliches EreignisUnterstützt von XNA FrameworkRowDeletingTritt ein, bevor eine Zeile in der Tabelle gelöscht wird.
Öffentliches EreignisUnterstützt von XNA FrameworkTableClearedTritt ein, nachdem eine DataTable gelöscht wurde.
Öffentliches EreignisUnterstützt von XNA FrameworkTableClearingTritt ein, wenn eine DataTable gelöscht wird.
Öffentliches EreignisUnterstützt von XNA FrameworkTableNewRowTritt ein, wenn eine neue DataRow eingefügt wird.
Zum Seitenanfang
  NameBeschreibung
Öffentliche ErweiterungsmethodeAsDataViewErstellt ein LINQ-aktiviertes DataView-Objekt und gibt es zurück. (Durch DataTableExtensions definiert.)
Öffentliche ErweiterungsmethodeAsEnumerableGibt ein IEnumerable<T>-Objekt zurück, bei dem der generische Parameter T gleich DataRow ist. Dieses Objekt kann in einem LINQ-Ausdruck oder einer Methodenabfrage verwendet werden. (Durch DataTableExtensions definiert.)
Zum Seitenanfang
  NameBeschreibung
Geschütztes FeldUnterstützt von XNA FrameworkfInitInProgressInfrastruktur. Überprüft, ob die Initialisierung gegenwärtig ausgeführt wird. Die Initialisierung erfolgt zur Laufzeit.
Zum Seitenanfang
  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate EigenschaftUnterstützt von XNA FrameworkIListSource.ContainsListCollectionEine Beschreibung dieses Members finden Sie unter IListSource.ContainsListCollection.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIListSource.GetListEine Beschreibung dieses Members finden Sie unter IListSource.GetList.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIXmlSerializable.GetSchemaEine Beschreibung dieses Members finden Sie unter IXmlSerializable.GetSchema.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIXmlSerializable.ReadXmlEine Beschreibung dieses Members finden Sie unter IXmlSerializable.ReadXml.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIXmlSerializable.WriteXmlEine Beschreibung dieses Members finden Sie unter IXmlSerializable.WriteXml.
Zum Seitenanfang

DataTable ist ein zentrales Objekt in der ADO.NET-Bibliothek. Zu den weiteren Objekten, die DataTable verwenden, zählen DataSet und DataView.

Beachten Sie beim Zugriff auf DataTable-Objekte, dass für diese die Groß- bzw. Kleinschreibung bedingt beachtet wird. Wenn z. B. eine DataTable "mydatatable" und eine weitere "Mydatatable" benannt ist, wird in einer Zeichenfolge zum Suchen einer dieser Tabellen die Groß- und Kleinschreibung unterschieden. Wenn jedoch "mydatatable", aber nicht "Mydatatable" vorhanden ist, wird in der Suchzeichenfolge die Groß- und Kleinschreibung nicht unterschieden. Ein DataSet kann zwei DataTable-Objekte mit demselben TableName-Eigenschaftswert, aber unterschiedlichen Namespace-Eigenschaftswerten enthalten. Weitere Informationen über das Arbeiten mit DataTable-Objekten finden Sie unter Creating a DataTable.

Beim programmgesteuerten Erstellen einer DataTable müssen Sie zuerst deren Schema definieren, indem Sie der DataColumnCollection (Zugriff über die Columns-Eigenschaft) DataColumn-Objekte hinzufügen. Weitere Informationen über das Hinzufügen von DataColumn-Objekten finden Sie unter Adding Columns to a Table.

Wenn Sie einer DataTable Zeilen hinzufügen möchten, müssen Sie zunächst mit der NewRow-Methode ein neues DataRow-Objekt zurückgeben. Mit der NewRow-Methode wird eine Zeile zurückgegeben, die das durch die DataColumnCollection der Tabelle definierte Schema der DataTable enthält. Die maximale Anzahl von Zeilen, die von einer DataTable gespeichert werden kann, ist 16.777.216. Weitere Informationen finden Sie unter Adding Data to a Table.

Die DataTable enthält außerdem eine Auflistung von Constraint-Objekten, mit denen die Datenintegrität sichergestellt werden kann. Weitere Informationen finden Sie unter Adding Constraints to a Table.

Es steht eine Vielzahl von DataTable-Ereignissen zur Verfügung, mit denen Änderungen an einer Tabelle bestimmt werden können. Dazu gehören RowChanged, RowChanging, RowDeleting und RowDeleted. Weitere Informationen über die Ereignisse, die mit einer DataTable verwendet werden können, finden Sie unter Working with DataTable Events.

Wenn eine Instanz von DataTable erstellt wird, werden einige Lese-/Schreibeigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im Thema zum DataTable.DataTable-Konstruktor.

HinweisHinweis

Das DataSet-Objekt und das DataTable-Objekt erben von MarshalByValueComponent und unterstützen die ISerializable-Schnittstelle für .NET Framework Remoting. Dies sind die einzigen ADO.NET-Objekte, die Sie für .NET Framework Remoting verwenden können.

TopicLocation
Gewusst wie: Erstellen von DataTablesDatenzugriff in Visual Studio
Gewusst wie: Erstellen von DataTablesDatenzugriff in Visual Studio

Im folgenden Beispiel werden zwei DataTable-Objekte und ein DataRelation-Objekt erstellt, und die neuen Objekte werden einem DataSet hinzugefügt. Die Tabellen werden dann in einem DataGridView-Steuerelement angezeigt.


// Put the next line into the Declarations section.
private System.Data.DataSet dataSet;

private void MakeDataTables()
{
    // Run all of the functions. 
    MakeParentTable();
    MakeChildTable();
    MakeDataRelation();
    BindToDataGrid();
}

private void MakeParentTable()
{
    // Create a new DataTable.
    System.Data.DataTable table = new DataTable("ParentTable");
    // Declare variables for DataColumn and DataRow objects.
    DataColumn column;
    DataRow row;

    // Create new DataColumn, set DataType, 
    // ColumnName and add to DataTable.    
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";
    column.ReadOnly = true;
    column.Unique = true;
    // Add the Column to the DataColumnCollection.
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.String");
    column.ColumnName = "ParentItem";
    column.AutoIncrement = false;
    column.Caption = "ParentItem";
    column.ReadOnly = false;
    column.Unique = false;
    // Add the column to the table.
    table.Columns.Add(column);

    // Make the ID column the primary key column.
    DataColumn[] PrimaryKeyColumns = new DataColumn[1];
    PrimaryKeyColumns[0] = table.Columns["id"];
    table.PrimaryKey = PrimaryKeyColumns;

    // Instantiate the DataSet variable.
    dataSet = new DataSet();
    // Add the new DataTable to the DataSet.
    dataSet.Tables.Add(table);

    // Create three new DataRow objects and add 
    // them to the DataTable
    for (int i = 0; i<= 2; i++)
    {
        row = table.NewRow();
        row["id"] = i;
        row["ParentItem"] = "ParentItem " + i;
        table.Rows.Add(row);
    }
}

private void MakeChildTable()
{
    // Create a new DataTable.
    DataTable table = new DataTable("childTable");
    DataColumn column;
    DataRow row;

    // Create first column and add to the DataTable.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.Int32");
    column.ColumnName = "ChildID";
    column.AutoIncrement = true;
    column.Caption = "ID";
    column.ReadOnly = true;
    column.Unique = true;

    // Add the column to the DataColumnCollection.
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.String");
    column.ColumnName = "ChildItem";
    column.AutoIncrement = false;
    column.Caption = "ChildItem";
    column.ReadOnly = false;
    column.Unique = false;
    table.Columns.Add(column);

    // Create third column.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.Int32");
    column.ColumnName = "ParentID";
    column.AutoIncrement = false;
    column.Caption = "ParentID";
    column.ReadOnly = false;
    column.Unique = false;
    table.Columns.Add(column);

    dataSet.Tables.Add(table);

    // Create three sets of DataRow objects, 
    // five rows each, and add to DataTable.
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 0 ;
        table.Rows.Add(row);
    }
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i + 5;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 1 ;
        table.Rows.Add(row);
    }
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i + 10;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 2 ;
        table.Rows.Add(row);
    }
}

private void MakeDataRelation()
{
    // DataRelation requires two DataColumn 
    // (parent and child) and a name.
    DataColumn parentColumn = 
        dataSet.Tables["ParentTable"].Columns["id"];
    DataColumn childColumn = 
        dataSet.Tables["ChildTable"].Columns["ParentID"];
    DataRelation relation = new 
        DataRelation("parent2Child", parentColumn, childColumn);
    dataSet.Tables["ChildTable"].ParentRelations.Add(relation);
}

private void BindToDataGrid()
{
    // Instruct the DataGrid to bind to the DataSet, with the 
    // ParentTable as the topmost DataTable.
    dataGrid1.SetDataBinding(dataSet,"ParentTable");
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Dieser Typ ist bei Multithread-Lesevorgängen sicher. Sie müssen alle Schreibvorgänge synchronisieren.

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.