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

Объект DataTable, который представляет одну таблицу находящихся в памяти реляционных данных, может создаваться и использоваться независимо или использоваться другими объектами .NET Framework, чаще всего как член DataSet.A DataTable, which represents one table of in-memory relational data, can be created and used independently, or can be used by other .NET Framework objects, most commonly as a member of a DataSet.

Объект DataTable можно создать с помощью соответствующего конструктора DataTable .You can create a DataTable object by using the appropriate DataTable constructor. Его можно добавить в набор данных с помощью метода Add , чтобы добавить его в коллекцию Tables объекта DataTable .You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

Объекты DataTable также можно создавать в наборе данных с помощью методов Fill или FillSchema объекта DataAdapter или из предопределенной или выводимой XML-схемы с помощью метода ReadXml, ReadXmlSchema или Инферксмлсчема методы набора данных.You can also create DataTable objects within a DataSet by using the Fill or FillSchema methods of the DataAdapter object, or from a predefined or inferred XML schema using the ReadXml, ReadXmlSchema, or InferXmlSchema methods of the DataSet. Обратите внимание, что после добавления DataTable в качестве члена коллекции таблиц из одного набора данныхнельзя добавить его в коллекцию таблиц любого другого набора данных.Note that after you have added a DataTable as a member of the Tables collection of one DataSet, you cannot add it to the collection of tables of any other DataSet.

При первом создании таблицы данных Таблицане имеет схемы (то есть структуры).When you first create a DataTable, it does not have a schema (that is, a structure). Чтобы определить схему таблицы, необходимо создать и добавить DataColumn объекты в коллекцию Columns таблицы.To define the schema of the table, you must create and add DataColumn objects to the Columns collection of the table. Кроме того, можно определить первичный ключевой столбец для таблицы, а также создать и добавить объекты ограничений в коллекцию ограничений таблицы.You can also define a primary key column for the table, and create and add Constraint objects to the Constraints collection of the table. Определив схему для DataTable, можно добавить строки данных в таблицу, добавив объекты DataRow в коллекцию Rows таблицы.After you have defined the schema for a DataTable, you can add rows of data to the table by adding DataRow objects to the Rows collection of the table.

При создании TableName таблицыданных значение свойства указывать не обязательно; свойство можно указать в другое время, либо оставить его пустым.You are not required to supply a value for the TableName property when you create a DataTable; you can specify the property at another time, or you can leave it empty. Однако при добавлении таблицы без значения TableName в набор данныхэтой таблице будет присвоено добавочное имя по умолчанию таблицыN, начинающееся с «Table» для Table0.However, when you add a table without a TableName value to a DataSet, the table will be given an incremental default name of TableN, starting with "Table" for Table0.

Примечание

Рекомендуется избегать соглашения об именовании "TableN" при указании значения TableName , так как указываемое имя может конфликтовать с существующим именем таблицы по умолчанию в наборе данных.We recommend that you avoid the "TableN" naming convention when you supply a TableName value, because the name you supply may conflict with an existing default table name in the DataSet. Если указанное имя уже существует, вызывается исключение.If the supplied name already exists, an exception is thrown.

В следующем примере создается экземпляр объекта DataTable и присваивается имя Customers.The following example creates an instance of a DataTable object and assigns it the name "Customers."

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

В следующем примере создается экземпляр DataTable путем его добавления в коллекцию Tables набора данных.The following example creates an instance of a DataTable by adding it to the Tables collection of a 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");  

См. такжеSee also