Hinzufügen von Spalten zu einer Tabelle

Eine DataTable enthält eine Auflistung von DataColumn-Objekten, auf die durch die Columns-Eigenschaft der Tabelle verwiesen wird. Diese Auflistung von Spalten definiert zusammen mit etwaigen Einschränkungen das Schema oder die Struktur der Tabelle.

Sie erstellen DataColumn-Objekte innerhalb einer Tabelle, indem Sie den DataColumn-Konstruktor verwenden oder die Add-Methode der Columns-Eigenschaft der Tabelle aufrufen, welche eine DataColumnCollection ist. Die Add-Methode akzeptiert optionale ColumnName-, DataType- und Expression-Argumente und erstellt eine neue DataColumn als Member der Auflistung. Sie akzeptiert außerdem ein vorhandenes DataColumn-Objekt, fügt dieses der Auflistung hinzu und gibt einen Verweis auf die hinzugefügte DataColumn zurück, falls angefordert. Da DataTable-Objekte nicht spezifisch für eine bestimmte Datenquelle sind, werden beim Angeben des Datentyps einer DataColumn .NET Framework-Typen verwendet.

Im folgenden Beispiel werden einer DataTable vier Spalten hinzugefügt.

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

Dim workCol As DataColumn = workTable.Columns.Add("CustID", Type.GetType("System.Int32"))
workColumn.AllowDBNull = false
workColumn.Unique = true

workTable.Columns.Add("CustLName", Type.GetType("System.String"))
workTable.Columns.Add("CustFName", Type.GetType("System.String"))
workTable.Columns.Add("Purchases", Type.GetType("System.Double"))
[C#]
DataTable workTable = new DataTable("Customers");

DataColumn workCol = workTable.Columns.Add("CustID", typeof(Int32));
workCol.AllowDBNull = false;
workCol.Unique = true;

workTable.Columns.Add("CustLName", typeof(String));
workTable.Columns.Add("CustFName", typeof(String));
workTable.Columns.Add("Purchases", typeof(Double));

Wie Sie sehen, sind die Eigenschaften für die CustID-Spalte so gesetzt, dass DBNull-Werte nicht zulässig sind und die Werte eindeutig sein müssen. Wenn Sie jedoch die CustID-Spalte als Primärschlüsselspalte der Tabelle definieren, wird die AllowDBNull-Eigenschaft automatisch auf false und die Unique-Eigenschaft automatisch auf true gesetzt. Weitere Informationen hierzu finden Sie unter Definieren eines Primärschlüssels für eine Tabelle.

Vorsicht   Wenn für eine Spalte kein Spaltenname bereitgestellt wird, erhält die Spalte den inkrementellen Standardnamen ColumnN, beginnend mit "Column1", wenn sie der DataColumnCollection hinzugefügt wird. Es wird davon abgeraten, die Benennungskonvention "ColumnN" zu verwenden, wenn Sie einen Spaltennamen bereitstellen, da dieser Name u. U. einen Konflikt mit einem bereits vorhandenen Standardspaltennamen in der DataColumnCollection verursacht. Wenn der angegebene Name bereits vorhanden ist, wird eine Ausnahme ausgelöst.

Siehe auch

Erstellen und Verwenden von Datentabellen | DataColumn-Klasse | DataColumnCollection-Klasse | DataTable-Klasse