建立 DataTable
DataTable 表示記憶體中關聯式資料的某個資料表,它可以單獨建立及使用,也可以由其他 .NET Framework 物件所使用,而它最常見用法是做為 DataSet 的成員。
您可以使用適當的 DataTable 建構函式來建立 DataTable 物件。 您可以使用 Add 方法將它新增 DataSet 物件的 Tables 集合中,即可將它新增 DataSet。
您也可以使用 DataAdapter 物件的 Fill 或 FillSchema 方法,或是使用 DataSet 的 ReadXml、ReadXmlSchema 或 InferXmlSchema 方法,從預先定義或推斷的 XML 結構描述,在 DataSet 中建立 DataTable 物件。 請注意,當您將 DataTable 新增為某個 DataSet 之 Tables 集合的成員時,您無法將它新增至任何其他 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 的執行個體,方法是將它新增至 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");