Заполнение набора данных с помощью адаптера данных DataAdapter
Объект ADO.NET DataSet является находящимся в оперативной памяти представлением данных, обеспечивающим согласованную реляционную программную модель, независимо от источника данных. Набор данных DataSet представляет собой полную совокупность данных, которая включает таблицы, ограничения и связи между таблицами. Набор данных DataSet является независимым от источника данных, поэтому DataSet может включать данные, локальные по отношению к приложению, а также данные из нескольких источников данных. Управление взаимодействием с существующими источниками данных осуществляется с помощью DataAdapter.
Свойство SelectCommand объекта DataAdapter представляет собой объект Command , получающий данные из источника данных. Свойства InsertCommand, UpdateCommandи DeleteCommand , принадлежащие DataAdapter , являются объектами Command , которые управляют обновлением данных в источнике данных в соответствии с изменениями данных в DataSet. Эти свойства подробно описаны в обновлении источников данных с помощью DataAdapters.
Метод 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 Mappings).
Примечание.
Если 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.
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. Необходимо сохранять соединения с источником данных лишь на такое короткое время, насколько это возможно, освобождая ресурсы для использования другими клиентскими приложениями.
Множество результирующих наборов
Если объект 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 2000. Заполненные таблицы связываются с помощью DataRelation, и список клиентов отображает заказы данного клиента. Дополнительные сведения об объектах см. в DataRelation разделе "Добавление dataRelations " и навигация по dataRelations.
' 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. Тип данных платформа .NET Framework decimal позволяет не более 28 значимых цифр, в то время как тип данных SQL Server decimal позволяет 38 значимых цифр. Если во время операции SqlDataAdapterFill определяет, что точность поля decimal SQL Server больше 28 символов, текущая строка не добавляется в DataTable. Вместо этого происходит событие FillError , которое позволяет определить, произойдет ли потеря точности, и предпринять соответствующие действия. Дополнительные сведения о событии FillError см. в разделе "Обработка событий DataAdapter". Для получения значения типа decimal SQL Server можно также использовать объект SqlDataReader и вызывать метод GetSqlDecimal .
ADO.NET 2.0 ввели расширенную поддержку System.Data.SqlTypes в этой DataSetверсии. Дополнительные сведения см. в разделе SqlTypes and the DataSet.
Разделы 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");
}
Когда операция Fill завершена, набор данных DataSet содержит две таблицы: Customers и CustomersOrders, в которых CustomersOrders представляет столбец, разбитый на разделы. Дополнительный столбец с именем Orders добавляется к таблице Customers , а дополнительный столбец с именем CustomersOrders добавляется к таблице CustomersOrders . Столбец Orders в таблице Customers устанавливается на автоприращение. DataRelation, CustomersOrders, создается с помощью столбцов, которые были добавлены к таблицам с Customers в виде дочерней таблицы. Следующие таблицы показывают некоторые образцы результатов.
TableName: Customers
| CustomerID | CompanyName | Заказы |
|---|---|---|
| ALFKI | Alfreds Futterkiste | 0 |
| ANATR | Ana Trujillo Emparedados y helados | 1 |
TableName: CustomersOrders
| CustomerID | OrderID | CustomersOrders |
|---|---|---|
| ALFKI | 10643 | 0 |
| ALFKI | 10692 | 0 |
| ANATR | 10308 | 1 |
| ANATR | 10625 | 1 |