Freigeben über

Erstellen einer DataTable

A DataTable, das eine Tabelle mit relationalen Daten im Arbeitsspeicher darstellt, kann unabhängig erstellt und verwendet werden, oder von anderen .NET Framework-Objekten verwendet werden, meist als Mitglied eines DataSet.

Sie können ein DataTable-Objekt mithilfe des entsprechenden DataTable-Konstruktors erstellen. Sie können es dem DataSet hinzufügen, indem Sie die Add-Methode verwenden, um es der Tables-Sammlung des DataSet-Objekts hinzuzufügen.

Sie können DataTable-Objekte auch in einem DataSet erstellen, indem Sie die Fill - oder FillSchema-Methoden des DataAdapter-Objekts oder ein vordefiniertes oder abgeleitetes XML-Schema mithilfe der Methoden ReadXml, ReadXmlSchema oder InferXmlSchema des DataSet verwenden. Beachten Sie, dass sie nach dem Hinzufügen einer DataTable als Mitglied der Tables-Auflistung eines DataSets nicht zur Auflistung von Tabellen eines anderen DataSets hinzugefügt werden können.

Wenn Sie eine DataTable zum ersten Mal erstellen, verfügt sie nicht über ein Schema (d. a. eine Struktur). Um das Schema der Tabelle zu definieren, müssen Sie Objekte erstellen und diese der DataColumn der Tabelle hinzufügen. Sie können auch eine Primärschlüsselspalte für die Tabelle definieren und Einschränkungsobjekte zur Constraints-Auflistung der Tabelle erstellen und hinzufügen. Nachdem Sie das Schema für eine DataTable definiert haben, können Sie der Tabelle Zeilen mit Daten hinzufügen, indem Sie der Rows-Auflistung der Tabelle DataRow-Objekte hinzufügen.

Sie müssen keinen Wert für die TableName Eigenschaft angeben, wenn Sie eine DataTable erstellen. Sie können die Eigenschaft zu einem anderen Zeitpunkt angeben oder leer lassen. Wenn Sie jedoch eine Tabelle ohne einen TableName-Wert zu einem DataSet hinzufügen, erhält die Tabelle einen inkrementellen Standardnamen von TabelleN, beginnend mit "Tabelle" für Tabelle0.

Hinweis

Es wird empfohlen, die Benennungskonvention "Tabelle N" beim Angeben eines TableName-Werts zu vermeiden, da der von Ihnen bereitgestellte Name möglicherweise mit einem vorhandenenStandardtabellennamen im DataSet in Konflikt steht. Wenn der angegebene Name bereits vorhanden ist, wird eine Ausnahme ausgelöst.

Im folgenden Beispiel wird eine Instanz eines DataTable-Objekts erstellt und ihm der Name "Customers" zugewiesen.

Dim workTable as DataTable = New DataTable("Customers")  

DataTable workTable = new DataTable("Customers");

Im folgenden Beispiel wird eine Instanz einer DataTable erstellt, indem sie der Tables-Auflistung eines DataSet hinzugefügt wird.

Dim customers As DataSet = New DataSet  
Dim customersTable As DataTable = _  
   customers.Tables.Add("CustomersTable")  

DataSet customers = new DataSet();  
DataTable customersTable = customers.Tables.Add("CustomersTable");

Siehe auch