.NET Framework 类库
SqlDataSource.Select 方法

注意:此方法在 .NET Framework 2.0 版中是新增的。

使用 SelectCommand SQL 字符串以及 SelectParameters 集合中的所有参数从基础数据库中检索数据。

命名空间:System.Web.UI.WebControls
程序集:System.Web(在 system.web.dll 中)

语法

Visual Basic(声明)
Public Function Select ( _
    arguments As DataSourceSelectArguments _
) As IEnumerable
Visual Basic(用法)
Dim instance As SqlDataSource
Dim arguments As DataSourceSelectArguments
Dim returnValue As IEnumerable

returnValue = instance.Select(arguments)
C#
public IEnumerable Select (
    DataSourceSelectArguments arguments
)
C++
public:
IEnumerable^ Select (
    DataSourceSelectArguments^ arguments
)
J#
public IEnumerable Select (
    DataSourceSelectArguments arguments
)
JScript
public function Select (
    arguments : DataSourceSelectArguments
) : IEnumerable

参数

arguments

DataSourceSelectArguments,用于请求对数据执行基本数据检索操作以外的操作。

返回值

一个数据行的 IEnumerable 列表。
异常

异常类型条件

InvalidOperationException

SqlDataSource 无法与基础数据源建立连接。

备注

如果 DataSourceMode 属性设置为 DataSet 值,则 Select 方法返回 DataView 对象,如果 DataSourceMode 属性设置为 DataReader 值,则该方法返回 IDataReader 对象。数据读取完毕后,关闭 IDataReader 对象。

在执行 Select 操作之前,调用 OnSelecting 方法来引发 Selecting 事件。您可以处理此事件以在执行 Select 操作之前检查参数的值并执行任何预处理。

Select 操作完成后,就会调用 OnSelected 方法来引发 Selected 事件。您可以处理此事件以检查所有返回值、错误代码,并执行任何后续处理。

如果 DataSourceMode 属性设置为 DataSet 值而且启用了缓存,则 SqlDataSource 对象在 Select 操作期间从该缓存检索数据并将数据保存到该缓存中。该缓存将根据由 CacheDurationCacheExpirationPolicy 属性共同指定的缓存行为进行创建、放弃或刷新。

Security note安全注意

在 Microsoft Windows 身份验证下使用客户端模拟时,数据在第一个用户访问它时被缓存。如果另一个用户请求同一数据,则会从缓存中检索该数据。对数据库执行另一个调用以验证用户对数据有访问权限时不会检索数据。如果希望数据可由多个用户访问,并且要求数据库的安全配置验证每个对数据的检索,请不要使用缓存。

如果 DataSourceMode 设置为 DataSet 值,而且已指定 FilterExpression 属性,则在 Select 操作期间,将使用所有提供的 FilterParameters 属性来计算该属性,并将得到的筛选器应用于数据列表。

Select 方法委托给与 SqlDataSource 控件关联的 SqlDataSourceView 对象的 Select 方法。为了执行数据检索操作,SqlDataSourceView 使用 SelectCommand 文本和任何关联的 SelectParameters 生成 DbCommand 对象,然后对基础数据库执行该 DbCommand

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0
请参见

标记 :


Page view tracker