Заполнение DataSet из DataAdapter (ADO.NET)

Статья
11/04/2008

Обновлен: November 2007

Набор данных ADO.NET DataSet находится в памяти и является представлением данных, предоставляющим согласованную реляционную программную модель, независимую от источника данных. Набор данных DataSet представляет собой полную совокупность данных, которая включает таблицы, ограничения и связи между таблицами. Набор данных DataSet является независимым от источника данных, поэтому DataSet может включать данные, локальные по отношению к приложению, а также данные из нескольких источников данных. Управление взаимодействием с существующими источниками данных осуществляется с помощью DataAdapter.

Свойство SelectCommand объекта DataAdapter представляет собой объект Command, получающий данные из источника данных. Свойства InsertCommand, UpdateCommand и DeleteCommand, принадлежащие DataAdapter, являются объектами Command, которые управляют обновлением данных в источнике данных в соответствии с изменениями данных в DataSet. Эти свойства подробнее описываются в разделе Обновление источников данных с помощью объектов DataAdapter (ADO.NET).

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

Примечание.
Использование DataAdapter для получения всей таблицы требует времени, особенно при наличии в ней большого числа строк. Это происходит вследствие того, что обращение к базе данных, обнаружение и обработка данных, а также передача данных клиенту занимают длительное время. Передача по запросу всей таблицы клиенту приводит также к блокировке всех строк на сервере. Для повышения производительности можно использовать предложение WHERE, что позволяет значительно уменьшить количество строк, возвращаемых клиенту. Можно также уменьшить количество данных, возвращаемых клиенту, с помощью явно заданного списка требуемых столбцов в инструкции SELECT. Еще одним хорошим решением проблемы является получение строк в пакетах (например, содержащих несколько сотен строк одновременно), а также получение следующего пакета только после завершения обработки текущего.

Использование DataAdapter для получения всей таблицы требует времени, особенно при наличии в ней большого числа строк. Это происходит вследствие того, что обращение к базе данных, обнаружение и обработка данных, а также передача данных клиенту занимают длительное время. Передача по запросу всей таблицы клиенту приводит также к блокировке всех строк на сервере. Для повышения производительности можно использовать предложение WHERE, что позволяет значительно уменьшить количество строк, возвращаемых клиенту. Можно также уменьшить количество данных, возвращаемых клиенту, с помощью явно заданного списка требуемых столбцов в инструкции SELECT. Еще одним хорошим решением проблемы является получение строк в пакетах (например, содержащих несколько сотен строк одновременно), а также получение следующего пакета только после завершения обработки текущего.

Метод Fill неявно использует объект DataReader для возврата имен и типов столбцов, используемых для создания таблиц в DataSet, и данных для заполнения строк таблиц в DataSet. Таблицы и столбцы создаются только в том случае, если они еще не существуют. В противном случае метод Fill использует существующую схему DataSet. Типы столбцов создаются в виде типов платформы .NET Framework в соответствии с таблицами в Сопоставления типов данных в ADO.NET. Первичные ключи создаются, только если они существуют в источнике данных и свойство DataAdapter**.MissingSchemaAction имеет значение MissingSchemaAction.**AddWithKey. Если Fill обнаруживает, что для таблицы существует первичный ключ, то данные в DataSet для строк, в которых значения столбцов первичного ключа совпадают со значениями в строках, возвращенных из источника данных, будут перезаписаны данными из источника данных. Если первичный ключ не найден, данные добавляются в таблицы DataSet. В методе Fill при заполнении DataSet используются все существующие сопоставления (см. в разделе Сопоставления DataAdapter, DataTable и DataColumn (ADO.NET)).

Примечание.
Если SelectCommand возвращает результаты OUTER JOIN, то DataAdapter не задает значение PrimaryKey для результирующего объекта DataTable. Чтобы обеспечить правильное обнаружение повторяющихся строк, пользователь должен определить первичный ключ, PrimaryKey. Дополнительные сведения см. в разделе Определение первичных ключей (ADO.NET).

Если SelectCommand возвращает результаты OUTER JOIN, то DataAdapter не задает значение PrimaryKey для результирующего объекта DataTable. Чтобы обеспечить правильное обнаружение повторяющихся строк, пользователь должен определить первичный ключ, PrimaryKey. Дополнительные сведения см. в разделе Определение первичных ключей (ADO.NET).

В следующем примере кода создается экземпляр SqlDataAdapter, в котором используется соединение SqlConnection для базы данных Northwind Microsoft SQL Server и заполняется DataTable в наборе данных DataSet списком клиентов. Инструкция SQL и аргументы SqlConnection, переданные в конструктор SqlDataAdapter, используются для создания свойства SelectCommand объекта SqlDataAdapter.

Пример

' Assumes that connection is a valid SqlConnection object.
Dim queryString As String = _
  "SELECT CustomerID, CompanyName FROM dbo.Customers"
Dim adapter As SqlDataAdapter = New SqlDataAdapter( _
  queryString, connection)

Dim customers As DataSet = New DataSet
adapter.Fill(customers, "Customers")

// Assumes that connection is a valid SqlConnection object.
string queryString = 
  "SELECT CustomerID, CompanyName FROM dbo.Customers";
SqlDataAdapter adapter = new SqlDataAdapter(queryString, connection);

DataSet customers = new DataSet();
adapter.Fill(customers, "Customers");

Примечание.
Код, показанный в данном примере, не открывает и закрывает Connection явным образом. Если соединение еще не открыто, то метод Fill неявно открывает Connection, которое используется DataAdapter. Если операция Fill открыла соединение, она также закрывает его при завершении Fill. Это позволяет упростить код при использовании отдельной операции, такой как Fill или Update. Однако при выполнении нескольких операций, требующих открытого соединения, можно повысить производительность приложения путем явного вызова метода Open объекта Connection, выполнения операций с источником данных и последующего вызова метода Close объекта Connection. Необходимо сохранять соединения с источником данных лишь на такое короткое время, насколько это возможно, освобождая ресурсы для использования другими клиентскими приложениями.

Код, показанный в данном примере, не открывает и закрывает Connection явным образом. Если соединение еще не открыто, то метод Fill неявно открывает Connection, которое используется DataAdapter. Если операция Fill открыла соединение, она также закрывает его при завершении Fill. Это позволяет упростить код при использовании отдельной операции, такой как Fill или Update. Однако при выполнении нескольких операций, требующих открытого соединения, можно повысить производительность приложения путем явного вызова метода Open объекта Connection, выполнения операций с источником данных и последующего вызова метода Close объекта Connection. Необходимо сохранять соединения с источником данных лишь на такое короткое время, насколько это возможно, освобождая ресурсы для использования другими клиентскими приложениями.

Несколько результирующих наборов

Если объект DataAdapter обнаруживает несколько результирующих наборов, то создает несколько таблиц в DataSet. Таблицы получают добавочное имя по умолчанию TableN, для Table0 начинающееся с «Table». Если имя таблицы передается в качестве аргумента методу Fill, то таблицы получают по умолчанию имя TableNameN с последовательно увеличивающимся суффиксом, но начиная с «TableName», а не с TableName0.

Заполнение DataSet из нескольких адаптеров данных DataAdapter

Предусмотрена возможность использовать с объектом DataAdapter любое количество наборов данных DataSet. Каждый объект DataAdapter может использоваться для заполнения одного или более объектов DataTable и решения задачи по передаче обновлений в соответствующий источник данных. Объекты DataRelation и Constraint могут добавляться к DataSet локально, что позволяет связывать данные из разнородных источников данных. Например, DataSet может содержать данные из базы данных Microsoft SQL Server, из базы данных IBM DB2, доступ к которой предоставляется с помощью OLE DB, и источника данных, предназначенного для получения XML-данных в виде потока. Один или несколько объектов DataAdapter могут обрабатывать соединение с каждым источником данных.

Пример

Следующий пример кода заполняет список клиентов из базы данных Northwind Microsoft SQL Server 2000 и список заказов из базы данных Northwind, хранимый в Microsoft Access 2000. Заполненные таблицы связываются с DataRelation, и список клиентов отображает заказы данного клиента. Дополнительные сведения об объектах DataRelation см. в разделах Добавление объектов DataRelation (ADO.NET) и Навигация в DataRelations (ADO.NET).

' Assumes that customerConnection is a valid SqlConnection object.
' Assumes that orderConnection is a valid OleDbConnection object.
Dim custAdapter As SqlDataAdapter = New SqlDataAdapter( _
  "SELECT * FROM dbo.Customers", customerConnection)

Dim ordAdapter As OleDbDataAdapter = New OleDbDataAdapter( _
  "SELECT * FROM Orders", orderConnection)

Dim customerOrders As DataSet = New DataSet()
custAdapter.Fill(customerOrders, "Customers")
ordAdapter.Fill(customerOrders, "Orders")

Dim relation As DataRelation = _
  customerOrders.Relations.Add("CustOrders", _
  customerOrders.Tables("Customers").Columns("CustomerID"), _ 
  customerOrders.Tables("Orders").Columns("CustomerID"))

Dim pRow, cRow As DataRow
For Each pRow In customerOrders.Tables("Customers").Rows
  Console.WriteLine(pRow("CustomerID").ToString())

  For Each cRow In pRow.GetChildRows(relation)
    Console.WriteLine(vbTab & cRow("OrderID").ToString())
  Next
Next

// Assumes that customerConnection is a valid SqlConnection object.
// Assumes that orderConnection is a valid OleDbConnection object.
SqlDataAdapter custAdapter = new SqlDataAdapter(
  "SELECT * FROM dbo.Customers", customerConnection);
OleDbDataAdapter ordAdapter = new OleDbDataAdapter(
  "SELECT * FROM Orders", orderConnection);

DataSet customerOrders = new DataSet();

custAdapter.Fill(customerOrders, "Customers");
ordAdapter.Fill(customerOrders, "Orders");

DataRelation relation = customerOrders.Relations.Add("CustOrders",
  customerOrders.Tables["Customers"].Columns["CustomerID"],
  customerOrders.Tables["Orders"].Columns["CustomerID"]);

foreach (DataRow pRow in customerOrders.Tables["Customers"].Rows)
{
  Console.WriteLine(pRow["CustomerID"]);
   foreach (DataRow cRow in pRow.GetChildRows(relation))
    Console.WriteLine("\t" + cRow["OrderID"]);
}

Тип decimal SQL Server

По умолчанию DataSet сохраняет данные с помощью типов данных платформы .NET Framework. Для большинства приложений благодаря этому появляется удобный способ представления сведений об источнике данных. Однако данное представление может вызвать проблему, если типом данных в источнике данных является применяемый в SQL Server тип decimal или numeric. Тип данных decimal платформы .NET Framework позволяет использовать максимум 28 значащих цифр, тогда как тип данных decimal SQL Server позволяет использовать 38 значащих цифр. Если во время операции FillSqlDataAdapter определяет, что точность поля decimal SQL Server больше 28 символов, текущая строка не добавляется в DataTable. Вместо этого происходит событие FillError, которое позволяет определить, произойдет ли потеря точности, и предпринять соответствующие действия. Дополнительные сведения о событии FillError см. в разделе Обработка событий DataAdapter (ADO.NET). Для получения значения типа decimal SQL Server можно также использовать объект SqlDataReader и вызывать метод GetSqlDecimal.

В ADO.NET 2.0 появилась расширенная поддержка System.Data.SqlTypes в DataSet. Дополнительные сведения см. в разделе SqlTypes и DataSet (ADO.NET).

Разделы OLE DB

Иерархические наборы строк, или разделы (тип DBTYPE_HCHAPTER в OLE DB, тип adChapter в ADO), могут использоваться для заполнения содержимого DataSet. Когда OleDbDataAdapter во время операции Fill обнаруживает столбец, разбитый на разделы, для этого столбца создается DataTable, данная таблица заполняется столбцами и строками из раздела. Таблице, созданной для разбитого на разделы столбца, присваивается имя, состоящее из имени родительской таблицы и имени разбитого на разделы столбца, в форме «ParentTableNameChapteredColumnName». Если в наборе данных DataSet уже содержится таблица, имя которой согласуется с именем разбитого на разделы столбца, то данными раздела заполняется текущая таблица. Если в существующей таблице нет столбца, совпадающего со столбцом, содержащимся в разделе, то добавляется новый столбец.

Перед заполнением таблиц в DataSet данными, содержащимися в разбитых на разделы столбцах, между родительской и дочерней таблицами иерархического набора строк создается связь путем добавления целочисленного столбца к родительской и дочерней таблицам, установки родительского столбца на автоприращение и создания DataRelation с помощью добавленных из обеих таблиц столбцов. Добавленной связи присваивается имя с использованием имен родительской таблицы и разбитого на разделы столбца в виде «ParentTableNameChapterColumnName».

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

Обратите внимание, что при использовании перегруженного метода DataAdapter.Fill, который принимает DataTable в качестве аргумента, заполняется только эта таблица. Целочисленный столбец с автоприращением все еще можно добавить в таблицу, но нельзя создать или заполнить дочернюю таблицу, а также нельзя создать связь.

В следующем примере используется поставщик MSDataShape для создания разбитого на разделы столбца для каждого клиента из списка клиентов. После этого DataSet заполняется данными.

Using connection As OleDbConnection = New OleDbConnection( _
  "Provider=MSDataShape;Data Provider=SQLOLEDB;" & _
  "Data Source=(local);Integrated " & _
  "Security=SSPI;Initial Catalog=northwind")

Dim adapter As OleDbDataAdapter = New OleDbDataAdapter( _
  "SHAPE {SELECT CustomerID, CompanyName FROM Customers} " & _
  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS Orders " & _
  "RELATE CustomerID TO CustomerID)", connection)

Dim customers As DataSet = New DataSet()

adapter.Fill(customers, "Customers")
End Using

using (OleDbConnection connection = new OleDbConnection("Provider=MSDataShape;Data Provider=SQLOLEDB;" +
  "Data Source=(local);Integrated Security=SSPI;Initial Catalog=northwind"))
{
OleDbDataAdapter adapter = new OleDbDataAdapter("SHAPE {SELECT CustomerID, CompanyName FROM Customers} " +
  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS Orders " +
  "RELATE CustomerID TO CustomerID)", connection);

DataSet customers = new DataSet();
adapter.Fill(customers, "Customers");
}

После завершения операции FillDataSet содержит две таблицы: Customers и CustomersOrders, где CustomersOrders представляет столбец, разбитый на разделы. Дополнительный столбец с именем Orders добавляется к таблице Customers, а дополнительный столбец с именем CustomersOrders добавляется к таблице CustomersOrders. Столбец Orders в таблице Customers устанавливается на автоприращение. DataRelation, CustomersOrders, создается с помощью столбцов, которые были добавлены к таблицам с Customers в виде дочерней таблицы. Следующие таблицы показывают некоторые образцы результатов.

TableName: Customers