Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - 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.

  Name Beschreibung
Öffentliche Methode Unterstützt von XNA Framework DataTable() Initialisiert eine neue Instanz der DataTable-Klasse ohne Argumente.
Öffentliche Methode Unterstützt von XNA Framework DataTable(String) Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen.
Geschützte Methode DataTable(SerializationInfo, StreamingContext) Initialisiert eine neue Instanz der DataTable-Klasse mit der SerializationInfo und dem StreamingContext.
Öffentliche Methode Unterstützt von XNA Framework DataTable(String, String) Initialisiert eine neue Instanz der DataTable-Klasse mit dem angegebenen Tabellennamen und Namespace.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft Unterstützt von XNA Framework CaseSensitive Gibt an, ob Vergleiche zwischen Zeichenfolgen in der Tabelle unter Berücksichtigung der Groß- und Kleinschreibung ausgeführt werden.
Öffentliche Eigenschaft Unterstützt von XNA Framework ChildRelations Ruft die Auflistung untergeordneter Beziehungen für diese DataTable ab.
Öffentliche Eigenschaft Unterstützt von XNA Framework Columns Ruft die Auflistung der Spalten ab, die zu dieser Tabelle gehören.
Öffentliche Eigenschaft Unterstützt von XNA Framework Constraints Ruft die Auflistung der Einschränkungen ab, die von dieser Tabelle verwaltet werden.
Öffentliche Eigenschaft Unterstützt von XNA Framework Container Ruft den Container für die Komponente ab. (Von MarshalByValueComponent geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework DataSet Ruft das DataSet ab, zu dem diese Tabelle gehört.
Öffentliche Eigenschaft Unterstützt von XNA Framework DefaultView Ruft eine benutzerdefinierte Sicht der Tabelle ab, wobei es sich um eine gefilterte Sicht oder eine Cursorposition handeln kann.
Öffentliche Eigenschaft Unterstützt von XNA Framework DesignMode Ruft einen Wert ab, der angibt, ob sich die Komponente gegenwärtig im Entwurfsmodus befindet. (Von MarshalByValueComponent geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework DisplayExpression Ruft 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 Eigenschaft Unterstützt von XNA Framework Events Ruft die Liste der an diese Komponente angefügten Ereignishandler ab. (Von MarshalByValueComponent geerbt.)
Öffentliche Eigenschaft Unterstützt von XNA Framework ExtendedProperties Ruft die Auflistung benutzerdefinierter Benutzerinformationen ab.
Öffentliche Eigenschaft Unterstützt von XNA Framework HasErrors Ruft einen Wert ab, der angibt, ob in einer Zeile in einer Tabelle des DataSet, zu dem die Tabelle gehört, Fehler aufgetreten sind.
Öffentliche Eigenschaft Unterstützt von XNA Framework IsInitialized Ruft einen Wert ab, der angibt, ob die DataTable initialisiert wurde.
Öffentliche Eigenschaft Unterstützt von XNA Framework Locale Ruft die Gebietsschemainformationen ab, die für den Vergleich von Zeichenfolgen in der Tabelle verwendet werden, oder legt diese fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework MinimumCapacity Ruft die Ausgangsgröße für diese Tabelle ab oder legt diese fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework Namespace Ruft den Namespace für die XML-Darstellung der in der DataTable gespeicherten Daten ab oder legt diesen fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework ParentRelations Ruft die Auflistung übergeordneter Beziehungen für diese DataTable ab.
Öffentliche Eigenschaft Unterstützt von XNA Framework Prefix Ruft den Namespace für die XML-Darstellung der in der DataTable gespeicherten Daten ab oder legt diesen fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework PrimaryKey Ruft ein Array von Spalten ab, die als Primärschlüssel für die Datentabelle verwendet werden, oder legt dieses fest.
Öffentliche Eigenschaft RemotingFormat Ruft das Serialisierungsformat ab oder legt dieses fest.
Öffentliche Eigenschaft Unterstützt von XNA Framework Rows Ruft die Auflistung der Zeilen ab, die zu dieser Tabelle gehören.
Öffentliche Eigenschaft Unterstützt von XNA Framework Site Ruft eine System.ComponentModel.ISite für die DataTable ab oder legt diese fest. (Überschreibt MarshalByValueComponent.Site.)
Öffentliche Eigenschaft Unterstützt von XNA Framework TableName Ruft den Namen der DataTable ab oder legt diesen fest.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Unterstützt von XNA Framework AcceptChanges Übernimmt alle Änderungen, die an dieser Tabelle seit dem letzten Aufruf von AcceptChanges vorgenommen wurden.
Öffentliche Methode Unterstützt von XNA Framework BeginInit Beginnt die Initialisierung einer DataTable, die in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit.
Öffentliche Methode Unterstützt von XNA Framework BeginLoadData Deaktiviert während des Ladens von Daten Benachrichtigungen, Indexverwaltung und Einschränkungen.
Öffentliche Methode Unterstützt von XNA Framework Clear Löscht alle Daten aus der DataTable.
Öffentliche Methode Unterstützt von XNA Framework Clone Klont die Struktur der DataTable, einschließlich aller Schemas und Einschränkungen der DataTable.
Öffentliche Methode Unterstützt von XNA Framework Compute Berechnet den angegebenen Ausdruck für die aktuellen Zeilen, die die Filterkriterien erfüllen.
Öffentliche Methode Unterstützt von XNA Framework Copy Kopiert die Struktur und die Daten für diese DataTable.
Öffentliche Methode Unterstützt von XNA Framework CreateDataReader Gibt einen DataTableReader zurück, der den Daten innerhalb dieser DataTable entspricht.
Geschützte Methode Unterstützt von XNA Framework CreateInstance Infrastruktur. Erstellt eine neue Instanz von DataTable.
Öffentliche Methode Unterstützt von XNA Framework Dispose() Gibt sämtliche von der MarshalByValueComponent verwendeten Ressourcen frei. (Von MarshalByValueComponent geerbt.)
Geschützte Methode Unterstützt von XNA Framework Dispose(Boolean) Gibt die vom MarshalByValueComponent verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Von MarshalByValueComponent geerbt.)
Öffentliche Methode Unterstützt von XNA Framework EndInit Beendet die Initialisierung einer DataTable, die in einem Formular oder von einer anderen Komponente verwendet wird. Die Initialisierung erfolgt zur Laufzeit.
Öffentliche Methode Unterstützt von XNA Framework EndLoadData Aktiviert nach dem Laden von Daten Benachrichtigungen, Indexverwaltung und Einschränkungen.
Öffentliche Methode Unterstützt von XNA Framework Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Unterstützt von XNA Framework Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von MarshalByValueComponent geerbt.)
Öffentliche Methode Unterstützt von XNA Framework GetChanges() Ruft eine Kopie der DataTable ab, die alle seit dem letzten Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommenen Änderungen enthält.
Öffentliche Methode Unterstützt von XNA Framework GetChanges(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 Methode Statischer Member Unterstützt von XNA Framework GetDataTableSchema Diese Methode gibt eine XmlSchemaSet-Instanz mit der WSDL (Web Services Description Language) zurück, die die DataTable für Webdienste beschreibt.
Öffentliche Methode Unterstützt von XNA Framework GetErrors Ruft ein Array von DataRow-Objekten ab, die Fehler enthalten.
Öffentliche Methode Unterstützt von XNA Framework GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetObjectData Füllt ein Serialisierungsinformationsobjekt mit den Daten, die zum Serialisieren des DataTable erforderlich sind.
Geschützte Methode Unterstützt von XNA Framework GetRowType Infrastruktur. Ruft den Zeilentyp ab.
Geschützte Methode Unterstützt von XNA Framework GetSchema Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.GetSchema.
Öffentliche Methode Unterstützt von XNA Framework GetService Ruft die Implementierung von IServiceProvider ab. (Von MarshalByValueComponent geerbt.)
Öffentliche Methode Unterstützt von XNA Framework GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode Unterstützt von XNA Framework ImportRow Kopiert eine DataRow in eine DataTable, wobei alle Eigenschafteneinstellungen sowie die ursprünglichen und die aktuellen Werte beibehalten werden.
Öffentliche Methode Unterstützt von XNA Framework Load(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 Methode Unterstützt von XNA Framework Load(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 Methode Unterstützt von XNA Framework Load(IDataReader, LoadOption, FillErrorEventHandler) Füllt eine DataTable mit Werten aus einer Datenquelle mit dem bereitgestellten IDataReader und unter Verwendung eines Fehlerbehandlungsdelegaten.
Öffentliche Methode Unterstützt von XNA Framework LoadDataRow(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 Methode Unterstützt von XNA Framework LoadDataRow(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 Methode Unterstützt von XNA Framework MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Unterstützt von XNA Framework Merge(DataTable) Führen Sie die angegebene DataTable mit der aktuellen DataTable zusammen.
Öffentliche Methode Unterstützt von XNA Framework Merge(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 Methode Unterstützt von XNA Framework Merge(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 Methode Unterstützt von XNA Framework NewRow Erstellt eine neue DataRow mit dem Schema der Tabelle.
Geschützte Methode Unterstützt von XNA Framework NewRowArray Infrastruktur. Gibt ein DataRow-Array zurück.
Geschützte Methode Unterstützt von XNA Framework NewRowFromBuilder Erstellt eine neue Zeile aus einer vorhandenen Zeile.
Geschützte Methode Unterstützt von XNA Framework OnColumnChanged Löst das ColumnChanged-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnColumnChanging Löst das ColumnChanging-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnPropertyChanging Löst das PropertyChanged-Ereignis aus.
Geschützte Methode OnRemoveColumn Benachrichtigt die DataTable, dass eine DataColumn entfernt wird.
Geschützte Methode Unterstützt von XNA Framework OnRowChanged Löst das RowChanged-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnRowChanging Löst das RowChanging-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnRowDeleted Löst das RowDeleted-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnRowDeleting Löst das RowDeleting-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnTableCleared Löst das TableCleared-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnTableClearing Löst das TableClearing-Ereignis aus.
Geschützte Methode Unterstützt von XNA Framework OnTableNewRow Löst das TableNewRow-Ereignis aus.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(Stream) Liest mit dem angegebenen Stream das XML-Schema und die XML-Daten in die DataTable.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(String) Liest das XML-Schema und die XML-Daten in die DataTable aus der angegebenen Datei.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(TextReader) Liest mit dem angegebenen TextReader das XML-Schema und die XML-Daten in die DataTable.
Öffentliche Methode Unterstützt von XNA Framework ReadXml(XmlReader) Liest das XML-Schema und die XML-Daten mit dem angegebenen XmlReader in die DataTable.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(Stream) Liest ein XML-Schema mit dem angegebenen Stream in die DataTable.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(String) Liest ein XML-Schema aus der angegebenen Datei in die DataTable.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(TextReader) Liest ein XML-Schema mit dem angegebenen TextReader in die DataTable.
Öffentliche Methode Unterstützt von XNA Framework ReadXmlSchema(XmlReader) Liest ein XML-Schema mit dem angegebenen XmlReader in die DataTable.
Geschützte Methode Unterstützt von XNA Framework ReadXmlSerializable Infrastruktur. Liest aus einem XML-Stream.
Öffentliche Methode Unterstützt von XNA Framework RejectChanges Führt einen Rollback aller Änderungen durch, die an der Tabelle seit dem Laden oder seit dem letzten Aufruf von AcceptChanges vorgenommen wurden.
Öffentliche Methode Unterstützt von XNA Framework Reset Setzt die DataTable auf den ursprünglichen Zustand zurück.
Öffentliche Methode Unterstützt von XNA Framework Select() Ruft ein Array aller DataRow-Objekte ab.
Öffentliche Methode Unterstützt von XNA Framework Select(String) Ruft ein Array aller DataRow-Objekte ab, die den Filterkriterien entsprechen.
Öffentliche Methode Unterstützt von XNA Framework Select(String, String) Ruft ein Array aller DataRow-Objekte, die die Filterkriterien erfüllen, in der angegebenen Sortierreihenfolge ab.
Öffentliche Methode Unterstützt von XNA Framework Select(String, String, DataViewRowState) Ruft ein Array aller DataRow-Objekte ab, die die Filterkriterien in der Sortierreihenfolge erfüllen und zum angegebenen Zustand passen.
Öffentliche Methode Unterstützt von XNA Framework ToString Ruft den TableName und den DisplayExpression, sofern vorhanden, als verkettete Zeichenfolge ab. (Überschreibt MarshalByValueComponent.ToString().)
Öffentliche Methode Unterstützt von XNA Framework WriteXml(Stream) Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen Stream.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(String) Schreibt den aktuellen Inhalt der DataTable als XML mit der angegebenen Datei.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(TextWriter) Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen TextWriter.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(XmlWriter) Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen XmlWriter.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(XmlWriter, Boolean) Schreibt den aktuellen Inhalt der DataTable als XML mit dem angegebenen XmlWriter.
Öffentliche Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXml(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 Methode Unterstützt von XNA Framework WriteXmlSchema(Stream) Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in den angegebenen Stream.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(String) Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema in die angegebene Datei.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(TextWriter) Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen TextWriter.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(XmlWriter) Schreibt die aktuelle Datenstruktur der DataTable als XML-Schema unter Verwendung des angegebenen XmlWriter.
Öffentliche Methode Unterstützt von XNA Framework WriteXmlSchema(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 Methode Unterstützt von XNA Framework WriteXmlSchema(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 Methode Unterstützt von XNA Framework WriteXmlSchema(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 Methode Unterstützt von XNA Framework WriteXmlSchema(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
  Name Beschreibung
Öffentliches Ereignis Unterstützt von XNA Framework ColumnChanged Tritt ein, nachdem ein Wert für die angegebene DataColumn in einer DataRow geändert wurde.
Öffentliches Ereignis Unterstützt von XNA Framework ColumnChanging Tritt ein, wenn ein Wert für die angegebene DataColumn in einer DataRow geändert wird.
Öffentliches Ereignis Unterstützt von XNA Framework Disposed Fügt einen Ereignishandler hinzu, der das Disposed-Ereignis für die Komponente überwacht. (Von MarshalByValueComponent geerbt.)
Öffentliches Ereignis Unterstützt von XNA Framework Initialized Tritt nach dem Initialisieren der DataTable auf.
Öffentliches Ereignis Unterstützt von XNA Framework RowChanged Tritt ein, nachdem eine DataRow erfolgreich geändert wurde.
Öffentliches Ereignis Unterstützt von XNA Framework RowChanging Tritt ein, wenn eine DataRow geändert wird.
Öffentliches Ereignis Unterstützt von XNA Framework RowDeleted Tritt ein, nachdem eine Zeile in der Tabelle gelöscht wurde.
Öffentliches Ereignis Unterstützt von XNA Framework RowDeleting Tritt ein, bevor eine Zeile in der Tabelle gelöscht wird.
Öffentliches Ereignis Unterstützt von XNA Framework TableCleared Tritt ein, nachdem eine DataTable gelöscht wurde.
Öffentliches Ereignis Unterstützt von XNA Framework TableClearing Tritt ein, wenn eine DataTable gelöscht wird.
Öffentliches Ereignis Unterstützt von XNA Framework TableNewRow Tritt ein, wenn eine neue DataRow eingefügt wird.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Erweiterungsmethode AsDataView Erstellt ein LINQ-aktiviertes DataView-Objekt und gibt es zurück. (Durch DataTableExtensions definiert.)
Öffentliche Erweiterungsmethode AsEnumerable Gibt 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
  Name Beschreibung
Geschütztes Feld Unterstützt von XNA Framework fInitInProgress Infrastruktur. Überprüft, ob die Initialisierung gegenwärtig ausgeführt wird. Die Initialisierung erfolgt zur Laufzeit.
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Eigenschaft Unterstützt von XNA Framework IListSource.ContainsListCollection Eine Beschreibung dieses Members finden Sie unter IListSource.ContainsListCollection.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IListSource.GetList Eine Beschreibung dieses Members finden Sie unter IListSource.GetList.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IXmlSerializable.GetSchema Eine Beschreibung dieses Members finden Sie unter der IXmlSerializable.GetSchema-Methode.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IXmlSerializable.ReadXml Eine Beschreibung dieses Members finden Sie unter IXmlSerializable.ReadXml.
Explizite Schnittstellenimplementierung Private Methode Unterstützt von XNA Framework IXmlSerializable.WriteXml Eine 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 Erstellen einer 'DataTable' (ADO.NET).

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 Hinzufügen von Spalten zu einer 'DataTable' (ADO.NET).

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 Hinzufügen von Daten zu einer 'DataTable'.

Die DataTable enthält außerdem eine Auflistung von Constraint-Objekten, mit denen die Datenintegrität sichergestellt werden kann. Weitere Informationen finden Sie unter 'DataTable'-Einschränkungen (ADO.NET).

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 Behandeln von DataTable-Ereignissen (ADO.NET).

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.

Hinweis Hinweis

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.

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, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.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-Inhalt Hinzufügen
Anmerkungen FAQ