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.

Примеры

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

<%@ 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 свойства хранится в состоянии представления.

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

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