建立 DataTable

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

您可以使用適當的 DataTable 建構函式來建立 DataTable 物件。 您可以使用 Add 方法將它新增 DataSet 物件的 Tables 集合中,即可將它新增 DataSet

您也可以使用 DataAdapter 物件的 FillFillSchema 方法,或是使用 DataSetReadXmlReadXmlSchemaInferXmlSchema 方法,從預先定義或推斷的 XML 結構描述,在 DataSet 中建立 DataTable 物件。 請注意,當您將 DataTable 新增為某個 DataSetTables 集合的成員時,您無法將它新增至任何其他 DataSet 的資料表集合。

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

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

注意

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

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

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

下列範例將建立 DataTable 的執行個體,方法是將它新增至 DataSetTables 集合。

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

另請參閱