Бөлісу құралы:

SqlDataSourceMode Перечисление

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Указывает, извлекает ли элемент управления SqlDataSource или AccessDataSource данные в виде IDataReader или DataSet.

public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode = 
Public Enum SqlDataSourceMode
Наследование
Object
ValueType
Enum
SqlDataSourceMode

Поля

Имя Значение Описание
DataReader 0

Извлекает данные из базового хранилища данных в виде IDataReader.
DataSet 1

Извлекает данные из базового хранилища данных в структуру DataSet .

Примеры

В следующем примере показано, как задать DataSourceMode свойство элемента управления DataReader при получении простого списка элементов из базы данных SQL Server в ListBox элемент SqlDataSource управления.

<%@ 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 значение при получении набора данных в GridView элемент управления с включенным сортировкой.

<!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 используется SqlDataSource элементами управления и AccessDataSource элементами управления для описания режима извлечения данных, используемого элементом управления источником данных при Select вызове метода. DataSourceMode Если для свойства задано DataSetзначение, данные загружаются в структуруDataSet. Это позволяет сценариям, в которых элементы управления пользовательским интерфейсом, такие как GridView возможности сортировки предложений и разбиения по страницам. DataSourceMode Если для свойства задано DataReaderзначение, данные извлекаются IDataReader объектом, который является курсором только для чтения.

Перечисление SqlDataSourceMode используется только для описания того, как Select команда извлекает данные; она не влияет на другие операцииSqlDataSource, выполняемые элементом управления, например InsertUpdate, или Delete.

Применяется к

См. также раздел