Поделиться через


Создание DataTable

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

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

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

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

При создании TableName не требуется указать значение для свойства; можно указать свойство в другое время или оставить его пустым. Однако при добавлении таблицы без значения TableName в Набор данных ей будет присвоено инкрементное имя по умолчанию вида TableN, начиная с "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");  

См. также