建立 DataTable

發行項
08/20/2007

DataTable 表示記憶體內關聯式資料的某個資料表，其可單獨建立及使用，也可以由其他 .NET Framework 物件所使用，最常見用法是做為 DataSet 的成員。

您可以使用適當的 DataTable 建構函式來建立 DataTable 物件。您可以藉由 Add 方法將它加入 DataTable 物件的 Tables 集合中，將它加入 DataSet。

您也可以使用 DataAdapter 物件的 Fill 或 FillSchema 方法，在 DataSet 中建立 DataTable 物件，或使用 DataSet 的 ReadXml、ReadXmlSchema 或 InferXmlSchema 方法，從預先定義或推斷的 XML 結構描述建立 DataTable 物件。請注意，當您將 DataTable 新增為某個 DataSet 的 Tables 集合的成員時，您無法將它加入至任何其他 DataSet 的資料表集合。

當您第一次建立 DataTable 時，它並不具有結構描述 (亦即結構)。若要定義資料表的結構描述，則必須建立 DataColumn 物件，並將其加入資料表的 Columns 集合。您也可以定義資料表的主索引鍵資料行，並且建立和新增 Constraint 物件到資料表的 Constraints 集合。當您已定義 DataTable 的結構描述後，您可以將資料列加入到資料表中，方法是將 DataRow 物件加入至資料表的 Rows 集合中。

建立 DataTable 時，不需提供 TableName 屬性的值；您可以在其他時候指定該屬性，或者將它保留空白。然而，當您將不具 TableName 值的資料表加入至 DataSet 時，該資料表會被指定 TableN 的累加預設名稱，從 Table0 的 "Table" 開始。

注意事項
當您提供 TableName 值時，建議您避免使用 "TableN" 命名慣例，因為您所提供的名稱可能會與 DataSet 中現有的預設資料表名稱衝突。如果提供的名稱已經存在，便會發生例外狀況。

下列範例將建立 DataTable 物件的執行個體，並為它指派 "Customers" 名稱。

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

DataTable workTable = new DataTable("Customers");

下列範例建立 DataTable 的執行個體，方法是將它加入至 DataSet 的 Tables 集合。

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

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

請參閱

共用方式為

建立 DataTable

請參閱

參考

概念

其他資源

其他資源