共用方式為

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 中定義的其中一個值。

範例

下列程式代碼範例示範如何使用不需要排序、分頁或篩選的控件，將控件DataReader的 SqlDataSource 屬性設定DataSourceMode為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 會儲存在檢視狀態中。

適用於

另請參閱