数据库-ADONET-使用DataAdapter对象

 

DataAdapter

如果想将查询结果存储在DataSet或DataTable对象中，比较简单的是使用DataAdapter对象。

1          DataAdapter对象

DataAdapter类是ADO.NET对象模型中联机和脱机这两部分的桥梁。

l         DataAdapter能将数据从数据库取出，再放到DataSet中；

l         DataAdapter还可以提取DataSet中存储在缓存中的更新数据，并提交给数据库

1.1         DataAdapter特性

DataAdapter对象,感觉上,好像与ADO的Command对象、RDO的rdoQuery对象、DAO的QueryDef对象相似；但是它们的差异明显。

1.1.1            DataAdapter的设计目的是处理脱机数据

DataAdapter是专门为处理脱机数据而设计的。

最好的例子是Fill方法，调用Fill方法可以不需要DataAdapter拥有与数据库间的活动连接：若在当前未开放的连接上调用Fill，DataAdapter会开发连接、查询数据库，然后填充结果到DataSet，最后关闭连接。

1.1.2            DataAdapter与DataSet间没有直接连接

在DataAdapter对象的Fill方法中传递DataSet对象作为参数，可以填充DataSet中的DataTable。

l         代码：

OleDbDataAdapter.Fill(DataSet)

调用Fill完成后，两个对象之间就没有连接了。（DataSet不会保存任何内在的或外在的对DataAdapter的引用；DataAdapter也不会保留对DataSet的引用）；DataSet不包含任何表明数据来源的信息（例如：连接字符串、表格名、列名称）。

因此，可以将DataSet对象从中间层服务器传递到客户端应用程序，不必担心泄露关于数据库位置与结构的信息。

1.1.3            DataAdapter中能包含回递给数据库的更新逻辑（存储在DataSet中）

DataAdapter也可以向数据库回递待定的更改。（这是与过去的数据访问模型的主要区别）

使用DataAdapter的Update方法提交更改。调用时需要DataSet对象作为参数。（DataSet能够缓存更改）

注意：实际的更新逻辑包含在DataAdapter对象中。

1.1.4            控制DataAdapter的更新逻辑

在DataAdapter中，可以自定义insert、update、delete查询，或使用存储过程提交更新。

DataAdapter拥有四项属性包含了Command对象，通过它们就可以分别指定自己的操作查询或存储过程；同样也可以分别指定能将数据在DataSet和存储过程之间来回移动的参数。

1.2         DataAdapter剖析（研究它的结构以及运作方式）

DataAdapter的设计目的在于帮助你将查询结果存储在DataSet对象和DataTable对象之中。

Command对象允许通过DataReader对象浏览查询结果。

DataAdapter对象由一系列Command对象组成，还包括一组用于确定DataAdapter与DataSet通信关系的映射属性。

1.2.1            子命令

使用DataAdapter将查询结果存储在DataSet中时，DataAdapter会使用一个Command对象来与数据库通讯；DataAdapter对象内在的使用了DataReader来取得结果数据，然后将信息复制到DataSet的新行去。（用循环逐行）

DataAdapter对象取数据的Command对象在其SelectCommand属性中。

插入数据的Command在其InsertCommand属性；删除数据的Command在其DeleteCommand属性；更新数据的Command在其UpdateCommand属性。

1.2.2            TableMapping集合

默认时，DataAdapter假设DataReader中的列与DataSet中的列是相匹配的。

如果，你希望DataSet的架构与数据库中的架构不同（一种可能是想给DataSet中的特定列使用不同的名称）：传统作法是，在查询中给列指定别名；现在，你可以使用TableMappings集合机制。

DataAdapter对象的TableMappings集合允许创建一个数据库和DataSet之间的映射层。

TableMappings属性返回一个DataTableMappingsCollection对象。

DataTableMappingsCollection对象含有一组DataTableMapping对象，其中每个对象都允许你在数据库中的某一个表（或视图、存储过程）与DataSet相应表之间创建映射。

而DataTableMapping对象含有一个ColumnMappings属性，它返回一个DataColumnMappingCollection对象。

DataColumnMappingCollection对象是由一组DataColumnMapping对象组成的集合，每一个DataColumnMapping都能将数据库一列映射为DataSet一列。

 

l         代码演示（填充TableMappings集合）

Dim da As OleDbAdapter

‘初始化Adapter

Dim tblMap as DataTableMapping

Dim colMap as DataColumnMapping

‘将表名对应

tblMap=da.TableMappings.Add(“Table”,”Employee”)

‘将列名对应

colMap=tblMap.ColumnMappings.Add(“EmpID”,”EmployeeID”)

colMap=tblMap.ColumnMappings.Add(“LName”,”LastName”)

colMap=tblMap.ColumnMappings.Add(“FName”,”FirstName”)

2          创建和使用DataAdapter对象

2.1         创建DataAdapter

注意：创建DataAdapter对象时，一般都希望SelectCommand属性是可用的Command对象。

l         代码

Dim strConn as String=”…”

Dim cn as new OleDbConnection(strConn)

Dim ssql as string=”select CustomerID,CompanyName from Customers”

Dim cmd as new OleDbCommand(ssql,cn)

Dim da as new OleDbAdapter()

da.SelectCommand=cmd

2.2         DataAdapter的构造函数

DataAdapter有4个构造函数（3个是带参数的）：

l              Public Sub New(ByVal selectCommand As OleDbCommand)

使用一个存在的Command作为SelectCommand使用

l              Public Sub New(ByVal selectCommandText As String, ByVal selectConnection As OleDbConnection)

使用一个存在的Connection连接对象，并根据传入的查询SQL潜在的构造SelectCommand对象

l              Public Sub New(ByVal selectCommandText As String, ByVal selectConnectionString As String)

此构造函数，潜在的为新DataAdapter构造一个Connection对象，并潜在的构造SelectCommand对象。

2.3         从查询中取得结果

2.3.1            使用Fill方法

调用Fill会：

1.        执行存储在SelectCommand属性中的查询

2.        将查询结果存储在DataSet中，如果未指定，则数据放在新创建的默认的DataTable对象（名Tabe）

n         代码：

Dim strConn,strSql as String

strConn=”…”

strSql=”Select CustomerID,CompanyName,ContactName,Phone from Customers”

Dim da as New OleDbDataAdapter(strSql,strConn)

Dim ds As new DataSet()

da.Fill(ds)

2.3.2            使用Fill方法创建DataTable对象和DataColumn对象

Fill方法会在DataSet对象中创建新的DataTable（如果没有指定DataTable名的话默认为‘Table’）此DataTable的列结构与查询结果相同。

在TableMappings集合中添加新TableMapping项目可以修改查询结果，改变其映射关系。

n         代码

Dim da as new OleDbDataAdapter(strSql,strConn)

Da.TableMappings.Add(“Table”,”Customers”) ‘此处将查询结果映射到名叫Customers的DataTable中

Dim ds as new DataSet()

da.Fill(ds)

2.3.3            使用重载的Fill方法

Fill的不同重载版本可以拥有更多的控制权。

2.3.3.1      指定DataTable

有两个Fill重载版本可以指定DataTable（这使你更灵活的控制DataTable）

2.3.3.1.1          填充时指定表名称

DataAdapter.Fill(DataSet,”MyTableName”)

2.3.3.1.2          填充时指派DataTable对象（而非DataSet）

DataAdapter.Fill(DataTable)

2.3.3.2      根据DataAdapter对象的Fill方法分页

Fill的一个重载版本可以获取查询结果的一部分（实现一部分分页的效果）

DataAdapter.Fill(DataSet,intStartRec,intRecCount,”Table Name”)

但是，你要牢记一点，即使你指定返回的是一部分结果，Fill方法还是将所以查询结果都返回，只不过将不需要的删去了。

所以，Fill方法简化查询分页的效率很一般。

2.3.3.3      用DataAdapter对象将一个Recordset的内容填充到DataSet对象

OLEDB.NET数据提供者的两个Fill重载版本，可以将数据从ADO Recordset复制到ADO.NET的DataSet中

2.3.3.3.1          OleDbAdapter.Fill(DataSet,AdoRecordset,”Table Name”)

2.3.3.3.2          OleDbAdapter.Fill(DataTable,AdoRecordset)

2.3.4            开放和关闭连接

n         DataAdapter对象和Command对象处理Connection对象的方法存在差异。

Command对象需要一个开放的Connection对象，否则Command会有异常。

DataAdapter对象没有这个限制。

调用DataAdapter.Fill方法（SelectCommand的Connection是关闭状态），DataAdapter会先开放连接，然后提交查询、取结果，最后关闭连接。

有时候，连续的使用DataAdapter的Fill方法，会使Connection对象连续的开放和关闭。怎么办？你可以给多个DataAdapter对象指定同一个Connection对象，并且在使用Fill方法之前，就用Connection.Open方法打开连接。

2.3.5            多次调用Fill方法

想一想：如何刷新DataSet中的数据，以便使用户能看到即时的更改。

最简单的办法就是清空DataSet或者DataTable，然后再次调用DataAdapter的Fill填充。

假使没有清空就连续调用（两次）Fill方法，那么你会在DataSet或DataTable中看到多个（两个）客户记录

对代码段来说，DataAdapter不能知道哪些客户是重复的。

通常，数据库的表中会定义一个主键。这样，能防止用户创建重复的行。

DataTable对象也有一个PrimaryKey属性。如果DataAdapter所填充的DataTable有一个主键，那么DataAdapter就会利用该主键来确定哪些行是重复的。（因此，在第一次填充后定义了DataTable的主键，那么第二次的填充DataAdapter会定位重复的行，删去旧值。）

下面假设第一次填充时，有一个客户记录被添加到DataTable中，之后，该客户记录被从数据库中删除了；此时如果进行第二次填充，客户记录会更新吗？不会，DataAdpater在查询结果中找不到该客户的信息，而且也不会将它从DataTable中删除。

想一想：怎么刷新全部数据？要先清空DataSet或DataTable，然后再次调用DataAdapter.Fill方法。（这样能确保没有重复行，同时确保数据库中没有的行不添加进DataSet）

2.4         将查询结果映射到DataSet中

使用DataAdapter对象的TableMappings集合

2.4.1            DataAdapter对象的TableMappings集合

TableMappings集合用来控制DataAdapter将DataSet映射到数据库的方式。

填充时，将TableMappings保留为空，调用Fill，然后将DataSet作为参数传递，且不指定表名称，DataAdapter会假定你要处理的是（名为Table）的DataTable

TableMappings属性返回一个类型为DataTableMappingCollection的对象。该对象内含多个DataTableMapping对象。可以如下添加：

DataAdapter.TableMappings.Add(“Table”,”Employees”) ‘告知DataAdapter与名为Employees的DataTable通讯

创建表映射之后，下一步可以创建列映射。例如：

Dim da as OleDbDataAdapter

Dim tblMap as DataTableMapping

Dim colMap as DataColumnMapping

tblMap=da.TableMappings.Add(“Table”,”Employees”)

colMap=tblMap.ColumnMappings.Add(“EmpID”,”EmployeeID”)

colMap=tblMap.ColumnMappings.Add(“Lname”,”LastName”)

colMap=tblMap.ColumnMappings.Add(“Fname”,”FirstName”)

2.4.2            MissingMappingAction属性

绝大多数情况下，开发人员在DataSet中都会使用与数据库中表相同的列名称。

当DataAdapter检查查询结果时，若发现某一列在其映射集合中不存在，它会检查MissingMappingAction属性以确定如何处理这些列。

MissingMappingAction属性接受System.Data名称空间中MissingMappingAction枚举类型的值。

默认值为Passthrough，表示DataAdapter将缺失的列映射为DataSet中同名的列；

值Ignore，表示忽略缺失的列；

值Error，表示若有缺失列时，会产生异常。

2.5         处理批查询

MS-Sql Server允许执行批查询。

Select CustomerID,CompanyName,ContactName,Phone from Customers where CustomerID=”ALFKI”

Select OrderID,CustomerID,EmployeeID,OrderDate from Orders where Customer=”ALFKI”

如果使用DataAdapter.Fill(DataSet)的方式取得DataSet，将会在DataSet中产生两个DataTable对象。每个DataTable保存一个查询的结果。一个名叫“Table”，一个名叫“Table1”

2.6         从存储过程中获取行

假设是Sql Server的存储过程（它能返回结果集）如下：

Create procedure GetAllCustomers as

       Select CustomerID,CompanyName,ContactName,Phone from Customers

Return

使用DataAdapter允许它并取得结果集放入DataSet或DataTable中。你可以使用下面的查询语句（两个）之一：

{CALL GetAllCustomers}或EXEC GetAllCustomers

另外，如果需要使用Command对象的CommandType属性作为DataAdapter的SelectCommand的话，还可以有更多的控制功能。

对于Oracle的存储过程，它不能从查询中返回行，仅能通过输出参数返回数据。

（Oracle的OLEDB提供者和Oracle的ODBC驱动程序允许开发者调用Oracle的存储过程，并通过输出参数取得查询结果。）

因此，Oracle的查询语法如下：

{CALL PackageName.ProcName (?, {resultset 20, OutParam1, OutParam2, …})}

2.7         获取架构信息

设计DataTable的目的在于加强数据上的约束,比如主键、字符串字段最大长度以及可空性限制等。

多数情况下，开发者不需要这些信息，DataAdapter能通过一些关键属性取得架构信息­——比如MissingSchemaAction属性和FillSchema方法

2.7.1            MissingSchemaAction属性

Fill方法使用的是不包含架构信息的DataSet对象和DataTable对象。

默认情况下，DataSet、DataTable没有那些列，DataAdapter会添加列信息来存储查询结果，这个操作就是有MissingSchemaAction来管理的。

MissingSchemaAction属性接受System.Data.MissingSchemaAction枚举类型的值。

默认值Add

可能值Ignore，表示忽略缺失列

可能值Error，表示有缺失列就产生异常。

可能值AddWithKey，表示有缺失列时，会在DataSet中添加缺失列，并且，设置MissingSchemaAction属性的两个附加属性：MaxLength和AllowDBNull。如果DataTable不存在或者DataTable不包含任何列，还会导致DataAdapter向数据库查找有关的主键信息。

2.7.2            FillSchema方法

此方法将架构信息存入DataSet或DataTable中.

此方法可以使用的参数：DataSet，DataTable或DataSet，表名称。

另外一个需要的参数是：SchemaType类型的值，取值Mapped或Source。（其中Mapped值将使DataAdapter使用TableMappings表映射的设置来应用返回列；而Source值则让DataAdapter使用查询结果来应用返回列）

另外，FillSchema方法会给返回列设置自增量（AutoIncrement）、允许空（AllowDBNull）、最大长度（MaxLength）等属性。

如果数据库中某列或某组列表示主键（或唯一键），FillSchema方法还要在结果DataTable上创建主键。