SqlDataSource.DataSourceMode Propiedad

Definición

Obtiene o establece el modo de la recuperación de datos que utiliza el control SqlDataSource para obtener los datos.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

Valor de propiedad

SqlDataSourceMode

Uno de los valores de SqlDataSourceMode.One of the SqlDataSourceMode values. El valor predeterminado es el DataSet valor.The default is the DataSet value.

Excepciones

La propiedad DataSourceMode no es uno de los valores definidos en SqlDataSourceMode.The DataSourceMode property is not one of the values defined in the SqlDataSourceMode.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la DataSourceMode propiedad del SqlDataSource control en el DataReader valor de un escenario con un ListBox control que no requiere ordenación, paginación ni filtrado.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>

Comentarios

El modo de recuperación de datos identifica cómo un SqlDataSource control recupera datos de la base de datos subyacente.The data retrieval mode identifies how a SqlDataSource control retrieves data from the underlying database.

Cuando la DataSourceMode propiedad se establece en el DataSet valor, los datos se cargan en un DataSet objeto y se almacenan en la memoria del servidor.When the DataSourceMode property is set to the DataSet value, data is loaded into a DataSet object and stored in memory on the server. Esto permite escenarios en los que los controles de interfaz de usuario, como GridView , ofrecen funciones de ordenación, filtrado y paginación.This enables scenarios where user interface controls, such as GridView, offer sorting, filtering, and paging capabilities.

Cuando la DataSourceMode propiedad se establece en el DataReader valor, un objeto recupera los datos IDataReader , que es un cursor de solo avance y de solo lectura.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. El tipo específico del IDataReader objeto depende del proveedor de datos de .net que SqlDataSource usa, que se identifica mediante la ProviderName propiedad.The specific type of the IDataReader object depends on the NET data provider that the SqlDataSource uses, which is identified by the ProviderName property. De forma predeterminada, el SqlDataSource control utiliza el proveedor para Microsoft SQL Server, System.Data.SqlClient y el lector de datos es un SqlDataReader objeto.By default, the SqlDataSource control uses the provider for Microsoft SQL Server, the System.Data.SqlClient, and the data reader is a SqlDataReader object.

Si cambia la DataSourceMode propiedad, DataSourceChanged se genera el evento, lo que provoca que los controles enlazados a se vuelvan SqlDataSource a enlazar.If you change the DataSourceMode property, the DataSourceChanged event is raised, causing any controls that are bound to the SqlDataSource to rebind.

El valor de la DataSourceMode propiedad se almacena en el estado de vista.The value of the DataSourceMode property is stored in view state.

Se aplica a

Consulte también