Создание таблицы данных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. Вы можете добавить его набора данных с помощью добавить метод, чтобы добавить его DataTable объекта таблиц коллекции.You can add it to the DataSet by using the Add method to add it to the DataTable object's Tables collection.

Вы также можете создать DataTable объектов в рамках набора данных с помощью заполнения или FillSchema методы DataAdapter объекта, или из предварительно определенных или выводимым XML-схемы с помощью ReadXml, ReadXmlSchema, или InferXmlSchema методы набора данных.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.

При первом создании DataTable, он не имеет схемы (т. е. структуры).When you first create a DataTable, it does not have a schema (that is, a structure). Чтобы определить схему таблицы, необходимо создать и добавить DataColumn объектов столбцы коллекции таблицы.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 объектов строк коллекции таблицы.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 свойства при создании DataTable; можно указать свойство в другое время, или оставить его пустым.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.

Примечание

Мы рекомендуем избегать» таблицыN"соглашение об именовании, при указании 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 путем добавления его в таблиц коллекцию набора данных.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