Создание таблицы данных

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

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

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

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

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

Примечание.

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

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

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

В следующем примере создается экземпляр DataTable, добавляя его в коллекцию таблиц набора данных.

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

См. также