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 屬性設定 DataSourceMode 為 DataReader 案例 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 會儲存在檢視狀態中。

適用於

另請參閱