SqlDataSourceMode SqlDataSourceMode SqlDataSourceMode SqlDataSourceMode Enum

定義

SqlDataSource コントロールまたは AccessDataSource コントロールの使用時に、データを IDataReader として取得するか、DataSet として取得するかを指定します。Specifies whether a SqlDataSource or AccessDataSource control retrieves data as a IDataReader or DataSet.

public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode = 
Public Enum SqlDataSourceMode
継承
SqlDataSourceModeSqlDataSourceModeSqlDataSourceModeSqlDataSourceMode

フィールド

DataReader DataReader DataReader DataReader 0

基になるデータ ストレージから、データを IDataReader として取得します。Retrieves data from the underlying data storage as an IDataReader

DataSet DataSet DataSet DataSet 1

基になるデータ ストレージから DataSet 構造体にデータを取得します。Retrieves data from the underlying data storage into a DataSet structure.

次のコード例は、設定する方法を示します、DataSourceModeDeleteDataReader に SQL Server データベースからの項目の簡単な一覧を取得するときにコントロール、ListBoxコントロール。The following code example demonstrates how to set the DataSourceMode of a Delete control to DataReader when retrieving a simple list of items from a SQL Server database into a ListBox control.

<%@ 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>

次のコード例は、設定する方法を示します、DataSourceModeデータセットへのデータのセットを取得するときに、GridViewを有効になっている並べ替えを持つコントロールです。The following code example demonstrates how to set the DataSourceMode to DataSet when retrieving a set of data into a GridView control that has sorting enabled.

<!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="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>
<!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="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

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

注釈

SqlDataSourceMode列挙型を使用して、SqlDataSourceAccessDataSource時にデータ ソース コントロールをデータ取得モードを記述するためのコントロールによって使用、Selectメソッドが呼び出されます。The SqlDataSourceMode enumeration is used by the SqlDataSource and AccessDataSource controls to describe the data retrieval mode that the data source control uses when the Select method is called. DataSourceModeプロパティは、データセットに設定されて、データが読み込まれます、DataSet構造体です。When the DataSourceMode property is set to DataSet, data is loaded into a DataSet structure. これにより、ユーザー インターフェイスが次のように制御するシナリオGridView並べ替えとページング機能を提供します。This enables scenarios where user interface controls such as GridView offer sorting and paging capabilities. DataSourceModeプロパティは、DataReader に設定されて、データを取得して、IDataReaderオブジェクトは読み取り専用で前方専用のカーソルです。When the DataSourceMode property is set to DataReader, data is retrieved by an IDataReader object, which is a read-only, forward-only cursor.

DataReaderを記述する列挙体を使用してのみ、どのようにSelectコマンドがデータを取得、その他の操作に影響を与えません;、SqlDataSourceModeコントロールを実行する次のようにInsertUpdate、またはDeleteThe DataReader enumeration is only used to describe how the Select command retrieves data; it has no effect on other operations the SqlDataSourceMode control performs, such as Insert, Update, or Delete.

適用対象

こちらもご覧ください