Создание DataTable

Объект DataTable, представляющий одну таблицу реляционных данных в памяти, можно создавать и использовать независимо или использовать другими объектами .NET Framework, чаще всего в качестве члена DataSet.

Объект DataTable можно создать с помощью соответствующего DataTable конструктора. Вы можете добавить его в DataSet, используя метод Add, чтобы добавить его в коллекцию объекта DataSetTables.

Вы также можете создавать объекты DataTable в пределах DataSet с помощью методов Fill или FillSchema объекта DataAdapter, или из предопределенной или выводимой схемы XML с использованием методов ReadXml, ReadXmlSchema или InferXmlSchema из DataSet. Обратите внимание, что после добавления DataTable в качестве члена Tables коллекции одного набора данных его нельзя добавить в коллекцию таблиц любого другого набора данных.

При первом создании DataTable она не имеет схемы (т. е. структуры). Чтобы определить схему таблицы, необходимо создать и добавить DataColumn объекты в Columns коллекцию таблицы. Можно также определить столбец первичного ключа для таблицы и создать и добавить Constraint объекты в Constraints коллекцию таблицы. После определения схемы для DataTable можно добавить строки данных в таблицу, добавив DataRow объекты в Rows коллекцию таблицы.

При создании TableName не требуется указать значение для свойства; можно указать свойство в другое время или оставить его пустым. Однако при добавлении таблицы без значения TableName в Набор данных таблице будет присвоено добавочное имя TableN, начиная с "Таблица" для Table0.

Замечание

Рекомендуется избегать соглашения об именовании таблицыN при предоставлении TableName значения, так как указанное имя может конфликтовать с существующим именем таблицы по умолчанию в Наборе данных. Если указанное имя уже существует, вызывается исключение.

В следующем примере создается экземпляр DataTable объекта и назначается имя "Клиенты".

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

В следующем примере создается экземпляр объекта DataTable , добавляя его в 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");

См. также