Erstellen einer "DataTable"Creating a DataTable

Eine DataTable, die eine Tabelle mit relationalen Daten im Speicher darstellt, kann erstellt und unabhängig verwendet werden. Oder sie kann von anderen .NET Framework-Objekten, am häufigsten als Member von einem DataSet, verwendet werden.A DataTable, which represents one table of in-memory relational data, can be created and used independently, or can be used by other .NET Framework objects, most commonly as a member of a DataSet.

Sie können ein Daten Objekt mit dem entsprechenden Daten tabellenkonstruktor erstellen.You can create a DataTable object by using the appropriate DataTable constructor. Sie können es dem DataSet hinzufügen, indem Sie die Add -Methode verwenden, um es der Tables- Auflistung des datables -Objekts hinzuzufügen.You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

Sie können mithilfe der Fill -Methode oder der FillSchema -Methode des DataAdapter -Objekts oder aus einem vordefinierten oder abgelegten XML-Schema mithilfe von "read XML" und "Read XmlSchema" auch Daten in einem DataSet erstellen.oder InferXmlSchema -Methoden des DataSets.You can also create DataTable objects within a DataSet by using the Fill or FillSchema methods of the DataAdapter object, or from a predefined or inferred XML schema using the ReadXml, ReadXmlSchema, or InferXmlSchema methods of the DataSet. Beachten Sie, dass Sie, nachdem Sie eine Datentabelle als Member der Tables -Auflistung eines DataSetshinzugefügt haben, Sie nicht zur Auflistung von Tabellen eines beliebigen anderen DataSetshinzufügen können.Note that after you have added a DataTable as a member of the Tables collection of one DataSet, you cannot add it to the collection of tables of any other DataSet.

Wenn Sie erstmalig eine DatenTabelle erstellen, hat Sie kein Schema (d. h. eine Struktur).When you first create a DataTable, it does not have a schema (that is, a structure). Um das Schema der Tabelle zu definieren, müssen Sie-Objekte erstellen DataColumn und der Columns -Auflistung der Tabelle hinzufügen.To define the schema of the table, you must create and add DataColumn objects to the Columns collection of the table. Sie können auch eine Primärschlüssel Spalte für die Tabelle definieren und Einschränkungs Objekte erstellen und der Einschränkungs Auflistung der Tabelle hinzufügen.You can also define a primary key column for the table, and create and add Constraint objects to the Constraints collection of the table. Nachdem Sie das Schema für eine DatenTabelle definiert haben, können Sie der Tabelle Daten Zeilen hinzufügen, indem Sie der Rows -Auflistung der Tabelle DataRow -Objekte hinzufügen.After you have defined the schema for a DataTable, you can add rows of data to the table by adding DataRow objects to the Rows collection of the table.

Sie müssen keinen Wert für die TableName -Eigenschaft angeben, wenn Sie eine DatenTabelle erstellen. Sie können die Eigenschaft zu einem anderen Zeitpunkt angeben, oder Sie können Sie leer lassen.You are not required to supply a value for the TableName property when you create a DataTable; you can specify the property at another time, or you can leave it empty. Wenn Sie jedoch eine Tabelle ohne TableName -Wert zu einem DataSethinzufügen, erhält die Tabelle einen inkrementellen Standardnamen der TabelleN, beginnend mit "Table" für Table0.However, when you add a table without a TableName value to a DataSet, the table will be given an incremental default name of TableN, starting with "Table" for Table0.

Hinweis

Es wird empfohlen, dass Sie die Benennungs Konvention "TableN" vermeiden, wenn Sie einen TableName -Wert angeben, da der von Ihnen bereitgestellte Name möglicherweise mit einem vorhandenen Standard Tabellennamen im DataSetin Konflikt steht.We recommend that you avoid the "TableN" naming convention when you supply a TableName value, because the name you supply may conflict with an existing default table name in the DataSet. Wenn der angegebene Name bereits vorhanden ist, wird eine Ausnahme ausgelöst.If the supplied name already exists, an exception is thrown.

Im folgenden Beispiel wird eine Instanz eines Daten Tabelle-Objekts erstellt und dem Namen "Customers" zugewiesen.The following example creates an instance of a DataTable object and assigns it the name "Customers."

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

Im folgenden Beispiel wird eine Instanz einer Datentabelle erstellt, indem Sie der Tables - Auflistung eines DataSetshinzugefügt wird.The following example creates an instance of a DataTable by adding it to the Tables collection of a DataSet.

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 auchSee also