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 値のいずれか 1 つ。 既定値は、DataSet です。

例外

DataSourceMode プロパティが SqlDataSourceMode に定義されている値ではありません。

次のコード例では、並べ替え、ページング、フィルター処理を必要としないコントロールDataReaderを使用ListBoxするシナリオで、 コントロールの プロパティSqlDataSourceを 値に設定DataSourceModeする方法を示します。

<%@ 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 型は、 が使用する SqlDataSource NET データ プロバイダーによって異なります。これは、 プロパティによって ProviderName 識別されます。 既定では、コントロールは SqlDataSource Microsoft SQL Server のプロバイダー を System.Data.SqlClient使用し、データ リーダーは オブジェクトです SqlDataReader

プロパティを DataSourceMode 変更すると、 DataSourceChanged イベントが発生し、 に SqlDataSource バインドされているコントロールが再バインドされます。

プロパティの DataSourceMode 値はビューステートに格納されます。

適用対象

こちらもご覧ください