SqlDataSource.DataSourceMode 属性

定义

获取或设置 SqlDataSource 控件获取数据所用的数据检索模式。

public:
 property System::Web::UI::WebControls::SqlDataSourceMode DataSourceMode { System::Web::UI::WebControls::SqlDataSourceMode get(); void set(System::Web::UI::WebControls::SqlDataSourceMode value); };
public System.Web.UI.WebControls.SqlDataSourceMode DataSourceMode { get; set; }
member this.DataSourceMode : System.Web.UI.WebControls.SqlDataSourceMode with get, set
Public Property DataSourceMode As SqlDataSourceMode

属性值

SqlDataSourceMode 值之一。 默认为 DataSet 值。

例外

DataSourceMode 属性不是 SqlDataSourceMode 中定义的任何一个值。

示例

下面的代码示例演示如何将 控件的 SqlDataSource 属性设置为DataSourceModeDataReader具有无需排序、分页或筛选的控件的方案ListBox的值。

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </form>
  </body>
</html>
<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </form>
  </body>
</html>

注解

数据检索模式标识控件如何 SqlDataSource 从基础数据库中检索数据。

当 属性 DataSourceMode 设置为 值时 DataSet ,数据将加载到 DataSet 对象中并存储在服务器上的内存中。 这样,用户界面控件(如 GridView)将提供排序、筛选和分页功能。

当 属性 DataSourceMode 设置为 值时 DataReader ,数据将由 IDataReader 对象检索,该对象是一个仅向前只读游标。 对象的特定类型 IDataReader 取决于 使用的 NET 数据提供程序,该访问接口 SqlDataSourceProviderName 属性标识。 默认情况下,控件 SqlDataSource 使用 Microsoft SQL Server 的提供程序, System.Data.SqlClient并且 数据读取器是 对象 SqlDataReader

如果更改 DataSourceMode 属性,则会 DataSourceChanged 引发 事件,导致绑定到 SqlDataSource 的任何控件重新绑定。

属性的值 DataSourceMode 存储在视图状态中。

适用于

另请参阅