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

Одно из значений перечисления SqlDataSourceMode. Значение по умолчанию — DataSet .

Исключения

Значение свойства DataSourceMode не равно ни одному из значений, определенных в SqlDataSourceMode.

Примеры

В следующем примере кода показано, как задать DataSourceMode свойству SqlDataSource элемента управления 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 свойства хранится в состоянии представления.

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

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