使用 SqlDataSource 控件选择数据

使用SqlDataSource 控件选择数据

使用SqlDataSource控件只需很少的代码或无需任何代码即可从数据库中检索数据。SqlDataSource控件可用于任何具有关联https://www.360docs.net/doc/1d16816077.html, 提供程序（在配置文件的DbProviderFactories节中配置）的数据库，包括Microsoft SQL Server、Oracle、ODBC 或OLE DB 数据库（如Microsoft Access）。您在配置时指定SqlDataSource使用的SQL 语句语法以及是否可以使用更高级的数据库功能（如存储过程）均由所用的数据库决定。但是，数据源控件对于所有数据库的操作都是相同的。

若要使用SqlDataSource控件从数据库中检索数据，至少需要设置以下属性：

?ProviderName设置为https://www.360docs.net/doc/1d16816077.html, 提供程序的名称，该提供程序表示您正在使用的数据库。如果您正在使用Microsoft SQL Server，请将ProviderName属性设置为

“System.Data.SqlClient”；如果您正在使用Oracle 数据库，请将ProviderName属性设置为“System.Data.OracleClient”；依此类推。

?ConnectionString设置为用于数据库的连接字符串。

?SelectCommand设置为从数据库中返回数据的SQL 查询或存储过程。为SelectCommand 属性设置的查询与在编写https://www.360docs.net/doc/1d16816077.html, 数据访问代码时为https://www.360docs.net/doc/1d16816077.html, IDbCommand对象的

CommandText属性设置的查询相同。SQL 查询的实际语法取决于您的数据架构和您所使用的数据库。

以下几节更详细地描述了这些属性。

指定提供程序名称

将ProviderName属性设置为https://www.360docs.net/doc/1d16816077.html, 提供程序的名称，该提供程序与存储数据的数据库的类型关联。允许的提供程序的列表在配置文件（Machine.config 或Web.config 文件）的DbProviderFactories节中注册。默认情况下，SqlDataSource控件使用对应于Microsoft SQL Server 的System.Data.SqlClient https://www.360docs.net/doc/1d16816077.html, 提供程序。因此，如果要连接到SQL Server 数据库，则无需显式指定提供程序。但是，您还可以指定System.Data.OracleClient、System.Data.Odbc或System.Data.OleDb提供程序。有关更多信息，请参见https://www.360docs.net/doc/1d16816077.html,。

注意

指定连接字符串

可将ConnectionString属性设置为用于特定数据库的连接字符串。不过，将SqlDataSource控件的ConnectionString属性设置为特定连接字符串，对于大型站点来说并不能算是一种易于维护的策略。另外，连接字符串以明文形式存储在https://www.360docs.net/doc/1d16816077.html, 页中。若要使Web 应用程序更易于维护并且安全性更高，建议将连接字符串存储在应用程序配置文件的connectionStrings元素中。然后可以用与下面示例中的连接表达式类似的连接表达式来引用存储的连接字符串：

复制

ID="SqlDataSource1"

runat="server"

ConnectionString="<%$ ConnectionStrings:NorthwindConnectionSt ring %>"

SelectCommand="SELECT * FROM [Categories]">

若要获得更高的安全性，可对配置节的内容进行加密。有关更多信息，请参见加密和解密配置节。

指定选择命令

可通过设置SqlDataSource控件的SelectCommand属性指定该控件要执行的SQL 查询。下面的示例演示一个SQL 查询，它检索包含Employees表中所有员工的姓的结果集：

复制

SELECT LastName FROM Employees;

下面的代码示例演示如何设置SqlDataSource控件的ConnectionString和SelectCommand属性，以便在GridView控件中显示Employees 数据：

C#

VB

复制

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

id="SqlDataSource1"

runat="server"

DataSourceMode="DataReader"

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

SelectCommand="SELECT LastName FROM Employees">

id="ListBox1"

runat="server"

DataTextField="LastName"

DataSourceID="SqlDataSource1">

J#

复制

id="SqlDataSource1"

runat="server"

DataSourceMode="DataReader"

ConnectionString="Data Source=localhost;Integrated Sec urity=SSPI;Initial Catalog=Northwind;"

SelectCommand="SELECT LastName FROM Employees">

id="ListBox1"

runat="server"

DataTextField="LastName"

DataSourceID="SqlDataSource1">

如果使用的数据库支持存储过程，则可以将SelectCommand属性设置为存储过程的名称，并将SelectCommandType属性设置为StoredProcedure，以指示SelectCommand属性引用一个存储过程。下面的示例演示一个可在SQL Server 中创建的简单存储过程：

复制

CREATE PROCEDURE sp_GetAllEmployees AS

SELECT * FROM Employees;

GO

若要配置SqlDataSource以使用此存储过程，请将SelectCommand文本设置为

“sp_GetAllEmployees”，并将SelectCommandType属性设置为StoredProcedure。

大多数存储过程都使用参数。有关使用带参数存储过程的更多信息，请参见对 SqlDataSource 控件使用参数。

在运行时，SqlDataSource控件将SelectCommand属性中的文本提交给数据库，数据库将查询或存储过程的结果返回给SqlDataSource控件。绑定到数据源控件的所有Web 控件都将在https://www.360docs.net/doc/1d16816077.html, 页上显示结果集。

将参数传递给SQL 语句

用户通常通过仅在运行时解析或计算的参数与数据进行交互。例如，https://www.360docs.net/doc/1d16816077.html, 网页上显示的数据可能表示特定日期的报表。如果用户选择不同的日期，则报表中的数据也可能会发生更改。无论是由用户显式更改日期还是由Web 应用程序以编程方式更改日期，如果提交到数据库的SQL 查询是参数化的SQL 查询（在这种查询中，SQL 语句的元素绑定到Web 应用程序变量并在运行时进行计算），则该SQL 查询会更为灵活且更易于维护。

通过将添加到SelectParameters集合的参数与SelectCommand查询中的占位符关联起来，SqlDataSource控件支持参数化SQL 查询。参数值可从页面上的其他控件、会话状态、用户配置文件以及其他元素中读取。有关更多信息，请参见对 SqlDataSource 控件使用参数。

占位符所用语法不尽相同，具体取决于数据库类型。如果使用SQL Server，则参数名以“@”字符开头，并且其名称与SelectParameters集合中的Parameter对象的名称相对应。如果使用ODBC 或OLE DB 数据库，则不对参数化语句中的参数命名，而是使用占位符“?”指定。

下面的示例演示参数化SQL 查询如何根据当前登录员工的员工ID 在SQL Server Northwind 数据库中检索所有订单。

复制

SELECT * FROM Orders WHERE EmployeeID = @empid

在此示例中，@empid表达式是在运行时计算的参数。

下面的代码示例演示一个参数化SQL 查询，该查询从页面上的其他控件获取参数值：

C#

VB

复制

id="DropDownList1"

runat="server"

autopostback="True">

Sales Representative

Sales Manager

Vice President, Sales

id="SqlDataSource1"

runat="server"

connectionstring="<%$ ConnectionStrings:MyNorthwind%> "

selectcommand="SELECT LastName FROM Employees WHERE Ti tle = @Title">

id="ListBox1"

runat="server"

datasourceid="SqlDataSource1"

datatextfield="LastName">

J#

复制

id="DropDownList1"

runat="server"

AutoPostBack="True">

Sales Representative

Sales Manager

Vice President, Sales

id="SqlDataSource1"

runat="server"

ConnectionString="Data Source=localhost;Integrated Sec urity=SSPI;Initial Catalog=Northwind;"

SelectCommand="SELECT LastName FROM Employees WHERE Ti tle = @Title">

id="ListBox1"

runat="server"

DataSourceID="SqlDataSource1"

DataTextField="LastName">

有关与SqlDataSource控件一起附带使用参数的更多信息，请参见对 SqlDataSource 控件使用参数。有关使用数据源参数的更多常规信息，请参见对数据源控件使用参数。

指定数据的返回方式

SqlDataSource控件的DataSourceMode属性确定SqlDataSource控件如何维护数据。默认情况下，DataSourceMode属性设置为DataSet，表示通过SqlDataSource控件将从数据库返回的结果集存储到服务器内存中。当SqlDataSource控件在DataSet模式下检索数据时，关联的数据绑定控件（如GridView和DetailsView）可提供丰富的数据显示功能，如自动排序和分页。

另外，还可以将DataSourceMode属性设置为DataReader，表示不将结果集存储在内存中。如果不需要将结果集保存在服务器的内存中，请使用DataReader模式。

下面的代码示例演示在不需要排序、分页或筛选时，如何将SqlDataSource控件的DataSourceMode属性设置为DataReader。

C#

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

id="SqlDataSource1"

runat="server"

DataSourceMode="DataReader"

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

SelectCommand="SELECT LastName FROM Employees">

id="ListBox1"

runat="server"

DataTextField="LastName"

DataSourceID="SqlDataSource1">

J#

id="SqlDataSource1"

runat="server"

DataSourceMode="DataReader"

ConnectionString="Data Source=localhost;Integrated Sec urity=SSPI;Initial Catalog=Northwind;"

SelectCommand="SELECT LastName FROM Employees">

id="ListBox1"

runat="server"

DataTextField="LastName"

DataSourceID="SqlDataSource1">

使用SqlDataSource 控件事件添加自定义处理

SqlDataSource控件公开那些您可以为了在控件执行数据检索操作前后运行自己的代码而处理的事件。

在调用Select方法执行SelectCommand属性中设置的SQL 查询之前，SqlDataSource控件会引发Selecting事件。您可以相应地处理Selecting事件，以便在运行SQL 查询之前先检查SQL 查询，验证SelectParameters集合中包含的参数，或在检索数据之前执行任何其他操作。例如，如果与SqlDataSource控件一起附带使用FormParameter，则可以处理用于在检索数据之前对参数值进行验证的Selecting事件。（FormParameter获取在HTML 元素中公布的值，并且不进行任何验证直接将其提交到数据库。）如果该值不可接受，则可以通过将SqlDataSourceSelectingEventArgs 对象的Cancel属性设置为true来取消该查询。

在完成了数据检索之后，SqlDataSource控件引发Selected事件。可以处理Selected事件，以确定在数据库操作期间是否引发异常，或对数据操作返回的任何值进行检查。

显示数据

若要在https://www.360docs.net/doc/1d16816077.html, 页上显示数据，请使用数据绑定控件（如GridView、DetailsView或FormView控件）或者使用ListBox或DropDownList等控件。数据绑定控件使用由SqlDataSource控件检索的数据。将数据绑定控件的DataSourceID属性设置为SqlDataSource控件的ID。当呈现页面时，SqlDataSource控件将检索数据并将数据提供给数据绑定控件，数据绑定控件显示该数据。有关数据绑定控件及如何与数据源控件一起使用数据绑定控件以显示数据的更多信息，请参见https://www.360docs.net/doc/1d16816077.html, 数据绑定 Web 服务器控件概述。

下面的代码示例演示如何使用GridView控件显示查询结果。

C#

id="SqlDataSource1"

runat="server"

DataSourceMode="DataReader"

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

SelectCommand="SELECT FirstName, LastName, Title FROM Employees">

id="GridView1"

runat="server"

DataSourceID="SqlDataSource1">

J#

id="SqlDataSource1"

runat="server"

DataSourceMode="DataReader"

ConnectionString="Data Source=localhost;Integrated Sec urity=SSPI;Initial Catalog=Northwind;"

SelectCommand="SELECT FirstName, LastName, Title FROM Employees">

id="GridView1"

runat="server"

DataSourceID="SqlDataSource1">