Заполнение набора данных DataSet с помощью DataAdapter
Область применения:
платформа .NET Framework .NET Standard
Объект ADO.NET DataSet является находящимся в оперативной памяти представлением данных, обеспечивающим согласованную реляционную программную модель, независимо от источника данных. Набор данных DataSet представляет собой полную совокупность данных, которая включает таблицы, ограничения и связи между таблицами. Набор данных DataSet является независимым от источника данных, поэтому DataSet может включать данные, локальные по отношению к приложению, а также данные из нескольких источников данных. Управление взаимодействием с существующими источниками данных осуществляется с помощью DataAdapter.
Свойство SelectCommand объекта DataAdapter представляет собой объект Command , получающий данные из источника данных. Свойства InsertCommand, UpdateCommandи DeleteCommand , принадлежащие DataAdapter , являются объектами Command , которые управляют обновлением данных в источнике данных в соответствии с изменениями данных в DataSet. Эти свойства более подробно описаны в разделе Обновление источников данных с помощью объектов DataAdapter.
Метод Fill объекта DataAdapter служит для заполнения набора данных DataSet результатами выполнения метода SelectCommand объекта DataAdapter. МетодFill принимает в качестве аргумента подлежащий заполнению набор данных DataSet , а также объект DataTable или имя объекта DataTable , который должен быть заполнен строками, возвращенными методом SelectCommand.
Примечание.
Использование 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).
Примечание.
Если SelectCommand возвращает результаты OUTER JOIN, то DataAdapter не задает значение PrimaryKey для результирующего объекта DataTable. Чтобы обеспечить правильное обнаружение повторяющихся строк, пользователь должен определить первичный ключ, PrimaryKey .
В следующем примере кода создается экземпляр SqlDataAdapter , в котором используется соединение SqlConnection для базы данных Northwind Microsoft SQL Server и заполняется DataTable в наборе данных DataSet списком клиентов. Инструкция SQL и аргументы SqlConnection , переданные в конструктор SqlDataAdapter , используются для создания свойства SelectCommand объекта SqlDataAdapter.
Пример
// 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. Необходимо сохранять соединения с источником данных лишь на такое короткое время, насколько это возможно, освобождая ресурсы для использования другими клиентскими приложениями.
Множество результирующих наборов
Если объект DataAdapter обнаруживает несколько результирующих наборов, то создает несколько таблиц в DataSet. Таблицы получают добавочное имя по умолчанию TableN, для Table0 начинающееся с «Table». Если имя таблицы передается в качестве аргумента методу Fill , то таблицы получают по умолчанию имя TableNameNс последовательно увеличивающимся суффиксом, но начиная с «TableName», а не с TableName0.
Заполнение DataSet из нескольких объектов DataAdapter
С DataSet можно использовать любое количество объектов DataAdapter. Каждый объект DataAdapter может использоваться для заполнения одного или более объектов DataTable и разрешения обновлений в соответствующем источнике данных. ОбъектыDataRelation и Constraint могут быть добавлены к DataSet локально, что позволяет связывать данные из разнородных источников данных. Например, DataSet может содержать данные из базы данных Microsoft SQL Server, базы данных IBM Db2, предоставляемой с помощью OLE DB, и источника данных, который передает XML. Один или несколько объектов DataAdapter могут обрабатывать соединение с каждым источником данных.
Пример
Следующий пример кода заполняет список клиентов из базы данных Northwind Microsoft SQL Server и список заказов из базы данных Northwind, который хранится в Microsoft Access. Заполненные таблицы связываются с помощью DataRelation, и список клиентов отображает заказы данного клиента.
// Assumes that customerConnection and orderConnection are valid SqlConnection objects.
SqlDataAdapter custAdapter = new SqlDataAdapter(
"SELECT * FROM dbo.Customers", customerConnection);
SqlDataAdapter ordAdapter = new SqlDataAdapter(
"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. Для большинства приложений благодаря этому появляется удобный способ представления сведений об источнике данных. Однако данное представление может вызвать проблему, если типом данных в источнике данных является применяемый в SQL Server тип decimal или numeric. Тип данных decimal платформы .NET позволяет использовать максимум 28 значащих цифр, тогда как тип данных decimal в SQL Server позволяет использовать 38 значащих цифр. Если во время операции SqlDataAdapterFill определяет, что точность поля decimal SQL Server больше 28 символов, текущая строка не добавляется в DataTable. Вместо этого происходит событие FillError , которое позволяет определить, произойдет ли потеря точности, и предпринять соответствующие действия. Дополнительные сведения о событии FillError см. в разделе Обработка событий DataAdapter. Для получения значения типа decimal SQL Server можно также использовать объект SqlDataReader и вызывать метод GetSqlDecimal .
ADO.NET имеет улучшенную поддержку для System.Data.SqlTypes в DataSet. Дополнительные сведения см. в разделе SqlTypes and the DataSet.