Scott Mitchell 的ASP.NET 2.0数据教程之四十七使用SqlDataSource控件检索数据

Scott Mitchell 的ASP.NET 2.0数据教程之四十七使用SqlDataSource控件检索数据

[align=left]前言：[/align]
[align=left]这是Scott Mitchell 的ASP.NET 2.0数据教程系列的第四十七篇，前四十六篇已经由论坛上的各位达人翻译出来了，不过第四十七到五十三篇我找了一下好象没有人翻译。小弟也是新手，找不到中文译文，只有自己硬者头皮上，加上英语水平有限，理解有误的地方请嘴下留情！另外如果哪位高人知道第四十七到五十三篇的中文翻译地址，麻烦回复一下，自己翻译起来实在是太慢了。再次谢过了！[/align]
[align=left]本文英文原版以及代码下载：[/align]
[align=left]http://www.asp.net/learn/dataaccess/tutorial47vb.aspx?tabid=63[/align]
[align=left][/align]

Scott Mitchell 的ASP.NET 2.0数据教程之四十七使用SqlDataSource控件检索数据
使用SqlDataSource控件检索数据

在前面的教程里，我们用ObjectDataSource控件充分的将表现层和数据访问层（DAL）分开来。在这篇教程里我们看看怎样在一个表现层和数据访问层区分的不是很严格的简单程序中使用SqlDataSource控件。

导言：
到目前为止，我们探讨的教程是由表现层，业务逻辑层和数据访问层构成的层次体系结构。数据访问层和业务逻辑层分别在教程第一和第二章提到。在Displaying Data With the ObjectDataSource 这篇教程里，我们探讨了怎样用ASP.NET 2.0的新控件--ObjectDataSource控件在表现层展示数据。
本教程到目前为止用这种层次结构来处理数据。然而绕过这种体系结构，通过直接把数据查询和业务逻辑放在Web页面上，也可以达到直接在ASP.NET页面上访问，插入，更新，删除数据库数据的目的。对十分庞大或者复杂的应用程序而言，使用层次结构对程序的成功和可维护性是很重要的。然而对很简单的程序来说，没有必要使用层次体系结构。
ASP.NET 2.0 提供了5个内建的数据源控件， SqlDataSource控件, AccessDataSource控件, ObjectDataSource控件, XmlDataSource控件, 和SiteMapDataSource控件。SqlDataSource控件能直接从关系型数据库中访问和更新数据，包括Microsoft SQL Server，Microsoft Access, Oracle, MySQL等数据库。在本章以及接下来的3章教程里面，我们将探讨如何用SqlDataSource控件来查询和筛选数据库数据，包括插入，更新和删除。





图1：ASP.NET 2.0 的5个内建的数据源控件

比较ObjectDataSource控件和 SqlDataSource控件
从理论上说，ObjectDataSource控件和 SqlDataSource控件都是作为访问数据的一种代理。就象在教程Displaying Data With the ObjectDataSource中讨论的那样，可以在ObjectDataSource控件中设置展示数据的数据类型，以及用来选择，插入，更新和删除数据所调用的方法。一旦完成了ObjectDataSource控件的设置，GridView, DetailsView, DataList等数据Web控件便可以通过绑定ObjectDataSource控件调用其Select(), Insert(), Delete(), 和 Update() methods方法。
虽然SqlDataSource控件具有和SqlDataSource控件同样的功能，但使用SqlDataSource控件时，我们必须提供详细的数据库连接字符串，以及用来执行选择，更新，插入，删除数据的ad-hoc SQL查询
或存储过程。当调用SqlDataSource控件的Select(), Insert(), Update(), and Delete() 方法时，SqlDataSource控件连接到数据库，并传递适当的SQL查询。下图展示了这些方法如何连接数据库，传递查询和返回结果。



图2 SqlDataSource控件充当访问数据库的代理

注意：在本章教程中我们主要关注如何从数据库获得数据，在后面的
Inserting, Updating, and Deleteing Data with the SqlDataSource
Control 教程中,我们将讨论如何通过设置SqlDataSource控件以支持插入，更新和删除数据。

SqlDataSource 控件和 AccessDataSource 控件
除了 SqlDataSource 控件外，ASP.NET 2.0 还包AccessDataSource 控件。这两种不同的控件使很多开发者误以为AccessDataSource 控件主要是被设计来与Microsoft Access数据库打交道，SqlDataSource 控件主要是被设计来来与Microsoft SQL Server打交道。实际情况是，SqlDataSource 控件可以与几乎所有.NET能访问的关系型数据库打交道。包括任何 OleDb， ODBC，compliant data stores,比如：Microsoft SQL Server, Microsoft Access, Oracle, Informix, MySQL, and PostgreSQL等。
SqlDataSource 控件和 AccessDataSource 控件的唯一区别在于AccessDataSource 控件的数据库连接信息只需要提供Access数据库文件的访问路径。而SqlDataSource 控件则需要提供完整的连接字符串。

第一步：创建 SqlDataSource 页面
在我们探讨用SqlDataSource控件直接操作数据库数据之前，让我们先花些时间在我们的站点项目里添加这些本节里和下三节里需要的ASP.NET页面。首先添加一个名为SqlDataSource的文件夹，在里面添加下列页面，并配置为使用Site.master母板页。
Default.aspx
Querying.aspx
ParameterizedQueries.aspx
InsertUpdateDelete.aspx
OptimisticConcurrency.aspx



图3：为SqlDataSource相关教程添加页面

类似在其它文件夹里，EditInsertDelete文件夹里的Default.aspx将列出这些教程章节。记得用户控件提供这个功能。因此，从解决方案资源管理器中拖拽一个这个用户控件到页面的设计视图，从而添加它到Default.aspx页面



图4：将用户控件添加到Default.aspx页面

最后把这4个页面加入站点地图中。打开Web.sitemap文件并且把下列代码加在“Adding Custom Buttons to the DataList and Repeater”siteMapNode标记之后：

<siteMapNode url="~/SqlDataSource/Default.aspx"
title="Using the SqlDataSource Control"
description="Work directly with database data using the
SqlDataSource control.">
<siteMapNode url="~/SqlDataSource/Querying.aspx"
title="Retrieving Database Data"
description="Examines how to query data from a database that
can then be displayed through a data Web control."/>
<siteMapNodeurl="~/SqlDataSource/ParameterizedQueries.aspx"
title="Parameterized Queries"
description="Learn how to specify parameterized WHERE
clauses in theSqlDataSource's SELECT statement." />
<siteMapNode url="~/SqlDataSource/InsertUpdateDelete.aspx"
title="Inserting, Updating, and Deleting Database Data"
description="See how to configure the SqlDataSource to include INSERT, UPDATE, and DELETE statements." />
<siteMapNode url="~/SqlDataSource/OptimisticConcurrency.aspx"
title="Using Optimistic Concurrency"
description="Explore how to augment the SqlDataSource to
include support for optimistic concurrency." />
</siteMapNode>



图5：更新站点地图使之包含新的页面

第二步：添加并设置 SqlDataSource控件

在SqlDataSource文件夹中打开Querying.aspx页面，切换到设计试图。从工具箱中拖一个SqlDataSource控件到设计器中，设置其ID 为 ProductsDataSource。和ObjectDataSource一样，SqlDataSource不产生任何的声明标记，所以现在在页面上看起来就象一个灰色的方块。点击SqlDataSource控件的智能标签，点“Configure Data Source”链接，进入数据源配置向导。



图6：在智能标签里点击“设置数据源”链接。

ObjectDataSource 控件和 SqlDataSource控件的配置向导有些许不同，但最终目的都是相同的：详细的说明了如何从数据库获取，插入，更新和删除数据。 ObjectDataSource控件明确指定了要访问的数据库，并提供了要使用的SQL查询声明或存储过程的详细情况
向导的第一步是选择要访问的数据库，在下拉列表中包含了放在App_Data 文件夹中的数据库，以及添加到服务器资源管理器的数据连接节点中的数据库。一旦我们将一个连接到App_Data文件夹中的NORTHWIND.MDF数据库的连接字符串添加到项目的Web.config 文件中，这个连接字符串就会出现在下拉列表的选项。如下图，选中它，点“下一步”。



图7：从下拉列表里选择NORTHWINDConnectionString

选择数据库后，向导转入“如何从数据库检索数据”界面。有2种方式：第一种指定自定义SQL语句或存储过程，第二种是指定来自表或视图的列。
注意：我们先探讨使用“指定来自表或视图的列”选项的实例，稍后再探讨用“自定义SQL语句或存储过程”选项的实例。

图8 是我们点击“指定来自表或视图的列”单选按钮时的画面，这里我们选择Products表，返回ProductID, ProductName和UnitPrice 列。完成选择后，在底部的方框内将显示SQL语句： SELECT [ProductID], [ProductName], [UnitPrice] FROM [Products]



图8：从表Products返回数据。

完成上述设置后，点“下一步”按钮，进入测试查询界面，在这里可以测试上一步所设置的查询的结果。点击“测试查询”按钮，执行查询。



图9：点击“测试”，从SELECT 查询检索数据。

最后，点“完成”按钮完成向导。

和ObjectDataSource 一样，SqlDataSource的向导设置只是完成了对SqlDataSource控件属性的赋值而已，即ConnectionString 属性和SelectCommand 属性。完成设置之后，我们的SqlDataSource控件代码应该和下面的差不多：
<asp:SqlDataSource ID="ProductsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:NORTHWNDConnectionString %>"
SelectCommand="SELECT [ProductID], [ProductName], [UnitPrice] FROM [Products]">
</asp:SqlDataSource>

其中ConnectionString 属性提供了怎样连接数据库的详细信息，可以用完整的，硬编码的连接字符串对其赋值，也可以用Web.config文件中的连接字符串来赋值。当用 Web.config文件中的字符串时，语法为：<%$ expressionPrefix:expressionValue %>，特别地expressionPrefix就是“ConnectionStrings”，而expressionValue 则是Web.config文件<connectionStrings>部分中，连接字符串的名字。关于此语法的更多信息请参考： ASP.NET Expressions Overview
而SelectCommand属性是SQL查询语句或存储过程的详细陈述。

第三步：添加数据Web控件并绑定到SqlDataSource

一旦设置好SqlDataSource 后，就可以用GridView 或DetailsView等数据Web控件绑定它。在本篇教程中我们使用GridView，从工具箱拖一个GridView控件到页面上，在智能标签中的 “选择数据源”里选ProductsDataSource ，这样就将GridView控件绑定到我们前面设置的SqlDataSource控件了。



图10：添加GridView控件并绑定到SqlDataSource

完成绑定后，Visual Studio 会自动为GridView从数据源控件返回的每一列添加一个BoundField 或CheckBoxField 。就本文来说既然SqlDataSource从数据库返回三列：ProductID, ProductName, 和 UnitPrice ，那么Visual Studio就在自动在GridView中生成三列（three fields ）。

花几分钟来设置GridView 的三个BoundFields：把ProductName field的HeaderText 属性设置为“Product Name”，UnitPrice field设置为“Price”，同时格式化为货币形式。修改后，你的GridView代码看起来应该象下面这样：

<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="False"
DataKeyNames="ProductID" DataSourceID="ProductsDataSource"
EnableViewState="False">
<Columns>
<asp:BoundField DataField="ProductID" HeaderText="ProductID"
InsertVisible="False" ReadOnly="True"
SortExpression="ProductID" />
<asp:BoundField DataField="ProductName" HeaderText="Product Name"
SortExpression="ProductName" />
<asp:BoundField DataField="UnitPrice" HeaderText="Price"
SortExpression="UnitPrice" DataFormatString="{0:c}"
HtmlEncode="False" />
</Columns>
</asp:GridView>

在浏览器中浏览本页，如图11所示，GridView列出了每个产品的ProductID, ProductName, 和UnitPrice。



图11：GridView里列出了每个产品的ProductID, ProductName, 和UnitPrice。

测试该页面时，GridView 调用其数据源控件的Select()方法。如果我们使用ObjectDataSource控件来测试该页面的话，它将会调用逻辑层ProductsBLL class的GetProducts() 方法。而用SqlDataSource控件的话，其Select()方法将直接链接到要访问的数据库，并传递SelectCommand（具体就本例而言，传递的是SELECT [ProductID], [ProductName], [UnitPrice] FROM [Products]）。SqlDataSource将返回的结果传递给GridView，后者根据从数据库返回的每一条记录生产一行（a row）

SqlDataSource控件及数据Web控件的内置属性

一般来说，数据Web控件的分页，排序，编辑，插入，删除等属性是由数据Web控件自身指定的，跟它所使用的数据源控件没有太大关系。也就是说，GridView可以自由的启用它内建的分页，排序，编辑和删除功能，而不管它到底是绑定到SqlDataSource控件还是ObjectDataSource控件。然而，数据Web控件的某些属性却要受其绑定的数据源控件及其设置的影响。

比如， 就像我们在Efficiently Paging Through Large Amounts of Data 这章教程中探讨的那样，在启用分页功能后，在默认情况下，每次跳转页面时，数据Web控件都会对所有的记录重新检索，尽管我们只需要显示特定的那几条记录。这种模式在要检索的数据量很大的情况下，效率会很低。不过ObjectDataSource控件可以通过自定义分页的方法仅仅返回那些需要在当前页面上显示的记录，很遗憾的是SqlDataSource控件不支持自定义分页功能。

在默认情况下，SqlDataSource控件返回的数据可以通过GridView控件来进行分页和排序。来做个示范，在Querying.aspx 页面中，在GridView控件的智能标签里启用分页和排序功能，看它是否象我们期望的那样工作。

分页和排序的原理在于SqlDataSource控件将检索的数据库数据转换成“泛型数据集”（loosely-typed DataSet）。那些被用来分页的每条记录就蕴含
在数据集里面，此外，数据集支持对返回的结果进行排序。当GridView请求对数据分页或排序时，SqlDataSource控件自动完成上述工作。

在默认情况下，SqlDataSource返回的是数据集（DataSet），你也可以使它返回一个DataReader ，方法是把它的DataSourceMode属性设置为“DataReader”。当希望把DataReader的检索结果转换为现成的代码（existing code ）时，设置为DataReader往往是首选。另外DataReader比起DataSet来简单的多，功能更强大。不过将DataSourceMode属性设置为“DataReader”后，数据Web控件便不能启用分页或排序功能，因为SqlDataSource无法得知总共返回了多少条记录，并且DataReader也不支持对返回的数据排序。

第四步：使用自定义的SQL查询或存储过程

前面讲到，SqlDataSource控件从数据库检索数据的方法有2种。在第二步我们探讨了从表Products返回数据的方法，现在我们探讨用自定义SQL查询的情况。

在Querying.aspx添加一个新的GridView控件，在其智能标签的下拉列表中
选择“新建数据源”，在“选择数据源类型”界面中选“database”，将数据
源ID设置为“ProductsWithCategoryInfoDataSource”。



图12：创建一个新的SqlDataSource控件，并命名为ProductsWithCategoryInfoDataSource

下一步，接着会询问使用哪个数据连接，就想我们在图7 做的那样，在下拉列表中选择NORTHWINDConnectionString，点下一步，在配置SQL语句界面中，选择“指定自定义SQL语句或存储过程”，点下一步，进入“定义自定义语句或存储过程”界面，包含“选择”，“更新”，“删除”，“插入”四个选项卡，在每个选项卡中，你可以在文本框中输入自定义SQL语句，或者在下拉列表中选择存储过程。本章我们讨论输入自定义SQL语句，在下面的教程中再探讨使用存储过程的情况。



图13：输入自定义SQL语句或选择某个存储过程

可以手工输入自定义SQL语句，也可以借助于查询生成器来辅助生成。不管
用哪种，都应使用如下查询：
SELECT Products.ProductID, Products.ProductName, Categories.CategoryName
FROM Categories
INNER JOIN Products ON
Categories.CategoryID = Products.CategoryID



图14：使用查询生成器图像化的构造查询

点下一步进入“测试查询”界面，点“完成”结束设置。

完成设置后，GridView的代码应该看起来象下面这样：
<asp:GridView ID="GridView2" runat="server" AutoGenerateColumns="False"
DataKeyNames="ProductID"
DataSourceID="ProductsWithCategoryInfoDataSource"
EnableViewState="False">
<Columns>
<asp:BoundField DataField="ProductID" HeaderText="ProductID"
InsertVisible="False" ReadOnly="True" SortExpression="ProductID" />
<asp:BoundField DataField="ProductName" HeaderText="ProductName"
SortExpression="ProductName" />
<asp:BoundField DataField="CategoryName" HeaderText="CategoryName"
SortExpression="CategoryName" />
</Columns>
</asp:GridView>
<asp:SqlDataSource ID="ProductsWithCategoryInfoDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:NORTHWNDConnectionString %>"
SelectCommand="
SELECT Products.ProductID, Products.ProductName, Categories.CategoryName
FROM Categories
INNER JOIN Products ON Categories.CategoryID = Products.CategoryID">
</asp:SqlDataSource>



图15：GridView显示了每个产品的ID, Name和Category Name

总结：
在本章我们探讨了怎样用SqlDataSource控件查询和显示数据。和ObjectDataSource控件一样，它们都是作为一种访问数据库的代理。我们可以在属性窗口中或通过设置它的数据源向导，来指定它要连接的数据库以及要执行的SQL选择查询（SQL SELECT query）
本文所探讨的SQL选择查询实例从指定的查询返回所以的记录，实际上SqlDataSource控件还可以包含一个带参数的WHERE字句。我们将在下一章探讨带参数的查询。

关于作者
Scott Mitchell，著有六本ASP/ASP.NET方面的书，是4GuysFromRolla.com的创始人，自1998年以来一直应用微软Web技术。Scott是个独立的技术咨询顾问，培训师，作家，最近完成了将由Sams出版社出版的新作，24小时内精通ASP.NET 2.0。他的联系电邮为mitchell@4guysfromrolla.com，也可以通过他的博客http: //ScottOnWriting.NET与他联系。