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

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

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

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