Создание объекта DataTable (ADO.NET)
Обновлен: November 2007
Объект DataTable, который представляет одну таблицу находящихся в памяти реляционных данных, может создаваться и использоваться независимо или использоваться другими объектами .NET Framework, чаще всего как член DataSet.
Объект DataTable можно создать, используя соответствующий конструктор для DataTable. Этот объект можно добавить в DataSet при помощи метода Add, чтобы добавить его в коллекцию Tables объекта DataTable.
Можно также создать объекты DataTable в DataSet при помощи методов Fill или FillSchema объекта DataAdapter либо из стандартной или выводимой схемы XML с использованием методов ReadXml, ReadXmlSchema или InferXmlSchema объекта DataSet. Следует отметить, что после добавления объекта DataTable как члена коллекции Tables объекта DataSet его нельзя добавить в коллекцию таблиц какого-либо другого объекта DataSet.
При первом создании объекта DataTable у него нет схемы (т. е. структуры). Для определения схемы таблицы необходимо создать и добавить объекты DataColumn в коллекцию Columns таблицы. Можно также определить столбец первичного ключа для таблицы, а также создать и добавить объекты Constraint в коллекцию Constraints таблицы. После определения схемы для таблицы DataTable можно добавить в таблицу строки данных, добавив объекты DataRow в коллекцию Rows таблицы.
Не требуется предоставлять значение для свойства TableName при создании объекта DataTable; свойство можно задать в любое время либо оставить его пустым. Однако при добавлении таблицы без значения TableName в объект DataSet таблице присваивается имя по умолчанию TableN с увеличивающимся каждый раз значением N на единицу, начиная с имени «Table» для Table0.
.gif "Примечание") Примечание. |
|---|
Мы рекомендуем избегать такого соглашения об именах, как «TableN» при предоставлении значения TableName, т. к. предоставляемое имя может вступать в конфликт с именем по умолчанию существующей таблицы в объекте DataSet. Если указанное имя уже существует, возникает исключение. |
В следующем примере создается экземпляр объекта DataTable, которому присваивается имя «Customers».
Dim workTable as DataTable = New DataTable("Customers")
DataTable workTable = new DataTable("Customers");
В следующем примере создается экземпляр таблицы DataTable добавлением его в коллекцию Tables объекта DataSet.
Dim customers As DataSet = New DataSet
Dim customersTable As DataTable = _
customers.Tables.Add("CustomersTable")
DataSet customers = new DataSet();
DataTable customersTable = customers.Tables.Add("CustomersTable");
См. также
Основные понятия
Заполнение DataSet из DataAdapter (ADO.NET)
Загрузка DataSet из XML (ADO.NET)
Загрузка сведений о схеме DataSet из XML (ADO.NET)