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 erstellen eine DataTable Objekt mit der entsprechenden DataTable Konstruktor.You can create a DataTable object by using the appropriate DataTable constructor. Hinzuzufügen, können Sie auf die DataSet mithilfe der hinzufügen Methode zum Hinzufügen der DataTable des Objekts Tabellen Auflistung.You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

Können Sie auch erstellen DataTable Objekte innerhalb einer DataSet mithilfe der füllen oder FillSchema Methoden der DataAdapter -Objekt, oder aus einem vordefinierten oder abgeleiteten XML-Schema mithilfe der ReadXml, ReadXmlSchema, oder InferXmlSchema Methoden der DataSet.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 nach dem Hinzufügen von einer DataTable als Mitglied der Tabellen Auflistung von einem DataSet, Sie können nicht auf die Auflistung von Tabellen mit jedem anderen HinzufügenDataSet.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.

Beim ersten Erstellen einer DataTable, er verfügt nicht über ein 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 erstellen und hinzufügen DataColumn Objekte die Spalten -Auflistung der Tabelle.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üsselspalte für die Tabelle definieren, und erstellen, und fügen Einschränkung Objekte die Einschränkungen -Auflistung der Tabelle.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 definiert haben eine DataTable, Sie können Zeilen mit Daten zur Tabelle hinzufügen, durch Hinzufügen von DataRow Objekte die Zeilen -Auflistung der Tabelle.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 sind nicht erforderlich, geben Sie einen Wert für die TableName Eigenschaft bei der Erstellung einer DataTable; Sie können diese Eigenschaft zu einem späteren Zeitpunkt festlegen, oder Sie lassen ihn leer.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. Jedoch beim Hinzufügen einer Tabelle ohne einen TableName -Werts in einen DataSet, in der Tabelle erhält einen 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 vermeiden, die "TabelleN" Benennungskonvention, wenn Sie angeben einer TableName Wert, der der Namen, die Sie angeben, ein Konflikt mit einem bereits vorhandenen Standardtabellennamen im kann die DataSet .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.

Das folgende Beispiel erstellt eine Instanz von einem DataTable -Objekt und weist ihr den Namen "Customers".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");  

Das folgende Beispiel erstellt eine Instanz von einem DataTable fügen es zu der Tabellen Auflistung von einer DataSet.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