SqlDataSource.DataSourceMode 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取或设置 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

SqlDataSourceMode 值之一。 默认为 DataSet 值。

例外

ArgumentOutOfRangeException

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 数据提供程序，该访问接口 SqlDataSource 由 ProviderName 属性标识。 默认情况下，控件SqlDataSource使用 Microsoft SQL Server 提供程序，System.Data.SqlClient并且 数据读取器是 对象SqlDataReader。

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

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

适用于

另请参阅