SqlDataSource.DataSourceMode Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el modo de la recuperación de datos que utiliza el control SqlDataSource para obtener los datos.

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. El valor predeterminado es DataSet.

Excepciones

ArgumentOutOfRangeException

La propiedad DataSourceMode no es uno de los valores definidos en 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.

<%@ 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.

Cuando la DataSourceMode propiedad se establece en el DataSet valor , los datos se cargan en un DataSet objeto y se almacenan en memoria en el servidor. Esto permite escenarios en los que los controles de la interfaz de usuario, como GridView, ofrecen funcionalidades de ordenación, filtrado y paginación.

Cuando la DataSourceMode propiedad se establece en el DataReader valor, un IDataReader objeto recupera los datos, que es un cursor de solo avance y de solo lectura. El tipo específico del IDataReader objeto depende del proveedor de datos NET que SqlDataSource usa, que se identifica mediante la ProviderName propiedad . De forma predeterminada, el SqlDataSource control usa el proveedor para Microsoft SQL Server, System.Data.SqlClienty el lector de datos es un SqlDataReader objeto .

Si cambia la DataSourceMode propiedad , se genera el DataSourceChanged evento , lo que provoca que los controles enlazados al se vuelvan a SqlDataSource enlazar.

El valor de la DataSourceMode propiedad se almacena en estado de vista.

Se aplica a

Consulte también