SqlDataSource.DataSourceMode Свойство

Определение

Возвращает или задает режим извлечения данных, используемый элементом управления SqlDataSource для выборки данных.Gets or sets the data retrieval mode that the SqlDataSource control uses to fetch data.

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.One of the SqlDataSourceMode values. Значение по умолчанию — DataSet.The default is the DataSet value.

Исключения

Значение свойства DataSourceMode не равно ни одному из значений, определенных в SqlDataSourceMode.The DataSourceMode property is not one of the values defined in the SqlDataSourceMode.

Примеры

В следующем примере кода показано, как задать для свойства DataSourceMode элемента управления SqlDataSource значение DataReader для сценария с элементом управления ListBox, который не требует сортировки, разбиения на страницы или фильтрации.The following code example demonstrates how to set the DataSourceMode property of the SqlDataSource control to the DataReader value for a scenario with a ListBox control that requires no sorting, paging, nor filtering.

<%@ 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 элемент управления извлекает данные из базовой базы данных.The data retrieval mode identifies how a SqlDataSource control retrieves data from the underlying database.

Если для свойства DataSourceMode задано значение DataSet, данные загружаются в объект DataSet и хранятся в памяти на сервере.When the DataSourceMode property is set to the DataSet value, data is loaded into a DataSet object and stored in memory on the server. Это позволяет выполнять сценарии, в которых элементы управления пользовательского интерфейса, такие как GridView, предлагают возможности сортировки, фильтрации и разбиения на страницы.This enables scenarios where user interface controls, such as GridView, offer sorting, filtering, and paging capabilities.

Если для свойства DataSourceMode задано значение DataReader, то данные извлекаются объектом IDataReader, который является однопроходным курсором только для чтения.When the DataSourceMode property is set to the DataReader value, data is retrieved by a IDataReader object, which is a forward-only, read-only cursor. Конкретный тип IDataReaderного объекта зависит от поставщика NET Data, который используется SqlDataSource, который определяется свойством ProviderName.The specific type of the IDataReader object depends on the NET data provider that the SqlDataSource uses, which is identified by the ProviderName property. По умолчанию элемент управления SqlDataSource использует поставщик для Microsoft SQL Server, System.Data.SqlClient, а модуль чтения данных — объект SqlDataReader.By default, the SqlDataSource control uses the provider for Microsoft SQL Server, the System.Data.SqlClient, and the data reader is a SqlDataReader object.

При изменении свойства DataSourceMode возникает событие DataSourceChanged, что приводит к повторной привязке всех элементов управления, привязанных к SqlDataSource.If you change the DataSourceMode property, the DataSourceChanged event is raised, causing any controls that are bound to the SqlDataSource to rebind.

Значение свойства DataSourceMode хранится в состоянии просмотра.The value of the DataSourceMode property is stored in view state.

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

Дополнительно