数据源控件

ASP.NET 2.0新增了一种被称为数据源控件的控件。这些控件不但可以使用数据库（如SQL Server、Access、Oracle等）、XML文件或中间层业务对象作为数据源；而且还可以连接到数据源，并从其中检索和修改数据。数据源控件共包括5个控件：SqlDataSource、AccessDataSource、ObjectDataSource、SiteMapDataSource和XmlDataSource控件。其中，前3个控件使用平面数据源，后两个控件使用层次数据源。它们之间的继承关系如图5.4所示。

图5.4 数据源控件的继承关系图

5.2.1 访问SQL数据——SqlDataSource

SqlDataSource数据源控件可以使用Microsoft SQL Server、ODBC、OLE DB、Oracle等基于SQL关系的数据库作为数据源。使用Microsoft SQL Server数据库时，该控件还提供数据缓存功能。另外，该控件还支持对数据进行选择、插入、更新、修改、排序、分页、缓存等操作。SqlDataSource控件的常用属性及其说明如表5-5所示。

表5-5 SqlDataSource控件的属性

属性	描述
DataSourceMode	获取数据的检索模式
ConnectionString	连接字符串
ProviderName	.NET Framework数据提供程序的名称
SelectCommand	检索数据的SQL字符串
SelectCommandType	指定SelectCommand属性的值是SQL语句或存储过程的名称
SelectParametersSelectCommand	SelectCommand属性使用的参数的集合
InsertCommand	插入数据的SQL字符串
InsertCommandType	指定InsertCommand属性的值是SQL语句或存储过程的名称
InsertParametersInsertCommand	InsertCommand属性使用的参数的集合
UpdateCommand	更新数据的SQL字符串

续表

属性	描述
UpdateCommandType	指定UpdateCommand属性的值是SQL语句或存储过程的名称
UpdateParametersUpdateCommand	UpdateCommand属性所使用的参数的集合
DeleteCommand	删除数据的SQL字符串
DeleteCommandType	指定DeleteCommand属性的值是SQL语句或存储过程的名称
DeleteParametersDeleteCommand	DeleteCommand属性使用的参数的集合

SqlDataSource控件分别为选择、插入、更新和删除操作提供了相应的方法，具体说明如表5-6所示。

表5-6 SqlDataSource控件的方法

属性	描述
Select()	使用SelectCommand属性和SelectParameters属性中的参数选择数据
Insert()	使用InsertCommand属性和InsertParameters属性中的参数插入数据
Update()	使用UpdateCommand属性和UpdateParameters属性中的参数更新数据
Delete()	使用DeleteCommand属性和DeleteParameters属性中的参数删除数据

注意	通常情况下，Select()、Insert()、Update()和Delete()方法不需要手工显示调用。

ConnectionString属性指定SqlDataSource控件的连接数据源或者数据库的连接字符串；DataSourceMode属性指定选择或检索数据的模式。该控件还可以从数据源或者数据库中选择数据，或对数据源或者数据库进行插入、更新和删除等操作，具体描述如下。

检索数据：SqlDataSource控件使用SelectCommand和SelectParameters属性来检索数据。其中，第一个属性指定检索数据的SQL语句或存储过程，第二个属性指定SQL语句或存储过程的参数集合。该控件调用Select()方法从数据源或者数据库中检索数据。

插入数据：SqlDataSource控件使用InsertCommand和InsertParameters属性实现插入数据的功能。其中，第一个属性指定插入数据的SQL语句或存储过程，第二个属性指定SQL语句或存储过程的参数集合。该控件调用Insert()方法将数据插入到数据源或者数据库。

更新数据：SqlDataSource控件使用UpdateCommand和UpdateParameters属性实现更新数据的功能。其中，第一个属性指定更新数据的SQL语句或存储过程，第二个属性指定SQL语句或存储过程的参数集合。该控件调用Update()方法更新数据源或者数据库中的数据。

删除数据：SqlDataSource控件可以使用DeleteCommand和DeleteParameters属性实现删除数据的功能。其中，第一个属性指定删除数据的SQL语句或存储过程，第二个属性指定SQL语句或存储过程的参数集合。该控件调用Delete()方法从数据源或者数据库中的删除数据。

下面的代码实例声明了一个ListBox控件和一个SqlDataSource控件。SqlDataSource控件为ListBox控件的数据源控件，为其提供数据。

注意	myDSUser控件从配置文件Web.config中获取了连接字符串。获取的程序代码如下：

ConnectionString="<%$ ConnectionStrings:WEB2ASPNET2DBConnectionString %>"

<%@ Page Language="C#" %>

<head runat="server"><title>访问SQL数据——SqlDataSource</title></head>

<asp:ListBox ID="lbUser" runat="server" DataSourceID="myDSUser"

DataTextField="UserName" DataValueField="ID" Rows="10"

Width="200px"></asp:ListBox>

<asp:SqlDataSource ID="myDSUser" runat="server" ConnectionString="<%$

ConnectionStrings:WEB2ASPNET2DBConnectionString %>"

SelectCommand="SELECT [ID], [UserName], [Email], [CreateDate]

FROM [User] WHERE ID > @ID">

<asp:Parameter DefaultValue="10" Name="UserID" />

</SelectParameters>

</asp:SqlDataSource>

</form></body>

</html>

在上述代码实例中，SqlDataSoruceCtl.aspx页面创建lbUser控件的数据源的操作步骤如下。

（1）选择lbUser控件，单击该控件的快捷菜单中的【显示智能标记】命令，如图5.5所示。

（2）单击【选择数据源】链接，弹出【数据源配置向导】对话框，如图5.6所示。

（3）在【选择数据源】下拉列表中选择【新建数据源】选项，弹出【数据源配置向导】对话框，如图5.7所示。在该对话框中，用户可以选择数据源的类型。在此，笔者选择了【数据库】类型，并设置数据源ID值为“myDSUser”。

图5.5 显示lbUser控件的智能标记图5.6 【数据源配置向导】对话框

（4）单击【确定】按钮，弹出【配置数据源 - myDSUser】对话框，如图5.8所示。在该对话框中，用户可以选择数据源的连接字符串。在此，笔者选择的数据源字符串为“WEB2ASPNET2DBConnectionString”。

（5）单击【下一步】按钮，弹出如图5.9所示对话框。在该对话框中，用户可以配置检索数据的Select语句。在此，笔者选择了用户表User，并检索了ID、UserName、E-mail和CreateDate 4个字段的数据。

图5.7 选择数据源的类型图5.8 选择数据连接

（6）单击【下一步】按钮，弹出如图5.10所示对话框。在该对话框中，用户可以测试步骤（5）中配置的Select语句。在此，笔者单击【测试查询】按钮，网格中显示了检索结果。

图5.9 配置Select语句图5.10 测试查询

（7）单击【完成】按钮，弹出【数据源配置向导】对话框，如图5.11所示。在该对话框中，用户可以选择数据源。在此，笔者选择了【myDSUser】数据源，并设置数据字段为“UserName”、值字段为“ID”。单击【确定】按钮，可以完成该数据源的配置过程。

（8）选择数据源控件myDSUser，并单击其【属性】面板中的【SelectQuery】中的【…】按钮，弹出【命令和参数编辑器】对话框，如图5.12所示。

图5.11 选择数据源图5.12 【命令和参数编辑器】对话框

（9）单击【添加参数】按钮，参数列表中将增加一个新的参数。在此，笔者设置新参数的名称为“ID”，其默认值为10，同时设置SELECT命令为“SELECT [ID], [UserName], [Email], [CreateDate] FROM [User] WHERE ID > @ID”。如图5.13所示。执行SqlDataSoruceCtl.aspx页面中的代码，结果如图5.14所示。

图5.13 添加新参数“ID” 图5.14 使用SqlDataSource控件访问SQL数据

5.2.2 访问Access数据源——AccessDataSource

AccessDataSource控件可以检索Microsoft Access数据库（文件后缀名为.mdb的文件）中的数据。同时，该控件也支持排序、筛选、分页等功能。AccessDataSource控件的属性如表5-7所示。

注意	AccessDataSource控件继承于SqlDataSource控件。

表5-7 AccessDataSource控件的属性

属性	描述
ConnectionString	连接到数据库或数据源的连接字符串
DataFile	数据库或数据源的文件所在位置
ProviderName	处理Access数据库的.NET数据提供程序的名称

注意	不能显式指定AccessDataSource控件的ConnectionString和ProviderName属性的值。在配置该控件的数据源时，一般只要设置它的DataFile属性的值即可。特别地，系统为ProviderName属性提供的默认值为“Microsoft.Jet.OLEDB.4.0 OLE DB”。

下面的代码实例声明了一个ListBox控件和一个AccessDataSource数据源控件。该数据源控件为ListBox控件的数据源控件，其数据源为“databse”文件夹下的Northwind.mdb文件。

<%@ Page Language="C#" %>

<head runat="server"><title>访问Access数据源——AccessDataSource</title>

</head>

<asp:ListBox ID="lbUser" runat="server" DataSourceID="myAccessDS"

DataTextField="ProductName" DataValueField="ProductID" Rows="10"

Width="200px"></asp:ListBox>

<asp:AccessDataSource ID="myAccessDS" runat="server"

DataFile="～/database/Northwind.mdb"

SelectCommand="SELECT [ProductID], [ProductName], [QuantityPerUnit],

[Discontinued], [ReorderLevel], [UnitsOnOrder], [UnitPrice],

[UnitsInStock] FROM [Products]">

</asp:AccessDataSource>

</form></body>

</html>

上述代码实例的执行结果如图5.15所示。

图5.15 AccessDataSource控件访问Access数据源

5.2.3 访问对象数据源——ObjectDataSource

ObjectDataSource控件可以使用自定义的业务对象、类或业务逻辑组件，它可以从这些对象、类或接口中检索数据。ObjectDataSource控件的功能非常强大，它提供了检索、更新、删除、插入、排序、过滤、分页、缓存等功能。ObjectDataSource控件的属性如表5-8所示。

表5-8 ObjectDataSource控件的属性

属性	描述
SelectCountMethod	检索行数的方法或函数的名称
SelectMethod	检索数据的方法或函数的名称
SelectParametersSelectMethod	SelectMethod方法使用的参数
InsertMethod	插入数据的方法或函数的名称
InsertParametersInsertMethod	InsertMethod方法使用的参数
UpdateMethod	更新数据的方法或函数的名称
UpdateParametersUpdateMethod	UpdateMethod方法使用的参数
DeleteMethod	删除数据的方法或函数的名称
DeleteParametersDeleteMethod	DeleteMethod方法使用的参数
FilterExpressionSelectMethod	检索数据时的过滤数据的表达式
FilterParameters	与过滤表达式相关的参数集合
SortParameterNameSelectMethod	检索数据时的排序数据的表达式
MaximumRowsParameterName	用于指示要检索的数据源分页支持的记录数
StartRowIndexParameterName	分页时第一条记录的标识
DataObjectTypeName	用于更新、插入或删除数据操作中的参数类的名称

续表

属性	描述
TypeName	与对象数据源相关的类的名称
EnablePaging	控件是否启用分页
EnableCaching	控件是否启用数据缓存

ObjectDataSource控件对指定的业务对象（数据源）可以执行选择、更新、插入、删除等操作。其中，SelectMethod、UpdateMethod、InsertMethod、DeleteMethod属性分别指定这些操作所需要的方法SelectParameters、UpdateParameters、InsertParameters、DeleteParameters属性分别指定这些方法所需要的参数。

在下述代码实例中，笔者创建了两个类：UserInfo和Users。其中，UserInfo类封装了用户的基本属性：UserID、Username、Email和LoginDate，这些属性分别表示用户的ID、名称、电子邮件和登录时间。Users类定义操作用户的方法：GetUsers()、AddUser(UserInfo ui)、UpdateUser(int userID,UserInfo ui)和DeleteUser(UserInfo ui)，这些方法分别用来执行检索、插入、更新和删除操作。Users类中的用户信息保存在泛型列表list中。

public class UserInfo

{

private int userID;private string username;

private string email;private DateTime loginDate;

public int UserID

{ ///属性UserID

get{return userID;}set{userID = value;}

}

public string Username

{ ///属性Username

get{return username;}set{username = value;}

}

public string Email

{ ///属性Email

get{return email;}set{email = value;}

}

public DateTime LoginDate

{ ///属性LoginDate

get{return loginDate;}set{loginDate = value;}

}

public class Users

{

/// <summary>

/// 保存用户信息的列表

/// </summary>

private List<UserInfo> list;

public Users()

{ ///初始化列表，并添加10条数据

list = new List<UserInfo>();

for(int i = 0; i < 10; i++)

{ ///构造用户信息

UserInfo ui = new UserInfo();

ui.UserID = i;

ui.Username = "MyName #" + (i + 1).ToString();

ui.Email = ui.Username + "@web.com";

ui.LoginDate = DateTime.Now;

list.Add(ui);

}

/// <summary>

/// 获取所有用户信息

/// </summary>

public List<UserInfo> GetUsers() { return list; }

/// <summary>

/// 增加一个用户信息

/// </summary>

public void AddUser(UserInfo ui) { list.Add(ui); }

/// <summary>

/// 更新一个用户信息

/// </summary>

public void UpdateUser(int userID,UserInfo ui) { list[userID] = ui; }

/// <summary>

/// 删除一个用户信息

/// </summary>

public void DeleteUser(UserInfo ui) { list.Remove(ui); }

}

下面的代码实例声明了一个ListBox控件和一个ObjectDataSource数据源控件。该数据源控件为ListBox控件的数据源控件，它的数据源为上述代码实例中定义的Users类。

<%@ Page Language="C#" %>

<head runat="server"><title>访问对象数据源——ObjectDataSource</title>

</head>

<asp:ListBox ID="lbUser" runat="server" DataSourceID="myObjectDS"

DataTextField="Username" DataValueField="UserID" Rows="10"

Width="200px"></asp:ListBox>

<asp:ObjectDataSource ID="myObjectDS" runat="server"

DataObjectTypeName="UserInfo" DeleteMethod="DeleteUser"

InsertMethod="AddUser" SelectMethod="GetUsers" TypeName="Users"

UpdateMethod="UpdateUser">

<asp:Parameter Name="userID" Type="Int32" />

<asp:Parameter Name="ui" Type="Object" />

</UpdateParameters>

</asp:ObjectDataSource>

</form></body>

</html>

上述代码实例的执行结果如图5.16所示。

图5.16 ObjectDataSource控件访问对象数据源Users

5.2.4 访问XML数据源——XmlDataSource

XmlDataSource控件使用层次结构（如XML文件等）的数据源，它的数据源往往是一个XML文件。

注意	XmlDataSource控件特别适用于分层的服务器控件，如TreeView、Menu等控件。

XmlDataSource控件提供了两种显示数据的方式：分层显示和表格显示。它提供了检索、更新、插入、删除、缓存等功能，其中，更新、插入、删除操作需要Save()方法支持。其最常用的方法是用于显示分层数据，且不能修改被显示的数据。XmlDataSource控件的属性如表5-9所示。

表5-9 XmlDataSource控件的属性

属性	描述
Data	绑定控件的XML块
DataFile	绑定控件的XML文件的文件名
Transform	定义XSLT转换的可扩展样式表语言（XSL）块
TransformFile	定义XSLT转换的可扩展样式表语言（XSL）文件的名称
XPath	XPath查询表达式，用于检索指定的XML数据
TransformArgumentList	XSLT参数的列表
CacheDuration	缓存持续的时间，单位为s
CacheExpirationPolicy	缓存过期行为
CacheKeyDependency	缓存的键依赖项
EnableCaching	控件是否启用数据缓存

DataFile属性指定XmlDataSource控件的数据源（往往是一个XML文件），该控件将从该XML文件中加载数据。另外，该控件还可以直接使用Data属性指定的XML数据作为数据源。当XmlDataSource控件从其数据源中加载数据时，还可以使用Transform和TransformFile属性指定的XSLT格式来转换加载数据的显示格式。

下面的代码实例创建了一个名称为User.xml的XML文件（保存在文件夹“files”下）。该文件定义了Users、User等元素。其中，User元素指定一个用户的基本属性，如ID、UserName、Email、CreateDate等。

<?xml version="1.0" ?>

<Users>

<User>

<Username>admin</Username>

<Email>admin@web2aspnet2.com</Email>

</User>

<User>

<Username>zydchina</Username>

<Email>dorient@126.com</Email>

</User>

<User>

<Username>dorient</Username>

<Email>admin@web2aspnet2.com</Email>

</User>

<User>

</User>

<User>

</User>

</Users>

下面的代码实例声明了一个XmlDataSource控件和一个TreeView控件（以树型结构显示数据），同时，把XmlDataSource控件作为TreeView控件的数据源控件。其中，XmlDataSource控件的数据源为上述代码实例定义的User.xml文件。

<%@ Page Language="C#" %>

<head runat="server"><title>访问XML数据源——XmlDataSource</title></head>

<asp:TreeView ID="tvUser" runat="server" DataSourceID="myXmlUser"

ImageSet="BulletedList" ShowExpandCollapse="False">

<SelectedNodeStyle Font-Underline="True" ForeColor="#5555DD"

HorizontalPadding="0px" VerticalPadding="0px" />

<NodeStyle Font-Names="Verdana" Font-Size="8pt" ForeColor="Black"

HorizontalPadding="0px" NodeSpacing="0px" VerticalPadding="0px" />

</asp:TreeView>

<asp:XmlDataSource ID="myXmlUser" runat="server"

DataFile="～/files/User.xml" XPath="/Users/User">

</asp:XmlDataSource>

</form></body>

</html>

上述代码实例的执行结果如图5.17所示。

图5.17 XmlDataSource控件访问XML数据源

5.2.5 访问站点地图数据源——SiteMapDataSource

SiteMapDataSource控件使用站点地图（后缀名为.sitemap的文件，该文件也是一个XML格式的文件）文件作为数据源。它能够从站点地图提供程序中检索导航数据，然后将数据传递给可显示该数据的控件。SiteMapDataSource控件的属性如表5-10所示。

表5-10 SiteMapDataSource控件的属性

属性	描述
ShowStartingNode	是否检索并显示起始节点
StartingNodeUrl	指定起始节点的路径。若该文件被检索数据，将该节点作为参照节点
StartingNodeOffset	起始节点的偏移量
StartFromCurrentNode	是否从当前节点开始检索
SiteMapProvider	站点地图提供程序的名称
Provider	与数据源控件关联的SiteMapProvider对象
ContainsListCollection	数据源控件是否包含数据源视图对象的集合

站点地图文件的名称为Web.sitemap。它是一个XML格式的文件，且包含siteMap和siteMapNode元素。下面的代码实例就是应用程序Sample_05_02的站点地图文件Web.sitemap的内容。

<?xml version="1.0" encoding="utf-8"?>

<siteMapNode url="SitemapDataSourceCtl.aspx"

title="SitemapDataSourceCtl.aspx页面" description="页面">

<siteMapNode url="files/User.xml" title="User.xml文件"

description="文件" />

<siteMapNode url="database/Northwind.mdb"

title="Northwind数据库" description="数据库" />

<siteMapNode url="App_Code/User.cs" title="User.cs文件"

description="类文件" />

</siteMapNode>

</siteMap>

在站点地图文件中，每一个siteMapNode元素都表示一个SiteMapNode对象。该对象提供了描述导航数据的属性，如Description、Title、Url、ParentNode等属性。SiteMapNode对象的属性说明如表5-11所示。

表5-11 SiteMapNode对象的属性

属性			描述
Description			节点的描述
Title			节点的标题
Url			节点所代表的页的URL
ChildNodes			节点的所有子节点集合
HasChildNodes			当前节点是否包含子节点
ParentNode			当前节点的父节点
RootNode			当前节点的根节点
	注意	SiteMapDataSource控件的默认数据源为它所在应用程序的站点地图文件Web.sitemap。在默认情况下，该控件从站点地图文件Web.sitemap的根节点开始检索数据。SiteMapDataSource控件专门用于显示导航数据，它不支持排序、筛选、分页、缓存、更新、插入、删除等操作。

下面的代码实例声明了一个SiteMapDataSource控件和一个TreeView控件（以树型结构显示数据），同时，把SiteMapDataSource控件设置为TreeView控件的数据源控件。其中，SiteMapDataSource控件的数据源为应用程序Sample_05_02的站点地图文件Web.sitemap。

<%@ Page Language="C#" %>

<head runat="server"><title>访问站点地图数据源——SiteMapDataSource</title>

</head>

<asp:SiteMapPath ID="smpWeb" runat="server" Font-Names="Verdana"

Font-Size="0.8em" PathSeparator=" : ">

</asp:SiteMapPath>

</form></body>

</html>

上述代码实例的执行结果如图5.18所示。

图5.18 SiteMapDataSource控件访问站点地图数据源