SqlDataSource.DataSourceMode Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define o modo de recuperação de dados que o controle SqlDataSource usa para buscar dados.

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 da propriedade

SqlDataSourceMode

Um dos valores de SqlDataSourceMode. O padrão é o valor DataSet.

Exceções

ArgumentOutOfRangeException

A propriedade DataSourceMode não é um dos valores definidos no SqlDataSourceMode.

Exemplos

O exemplo de código a seguir demonstra como definir a DataSourceMode propriedade do SqlDataSource controle para o DataReader valor de um cenário com um ListBox controle que não requer classificação, paginação nem filtragem.

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

Comentários

O modo de recuperação de dados identifica como um SqlDataSource controle recupera dados do banco de dados subjacente.

Quando a DataSourceMode propriedade é definida como o valor, os DataSet dados são carregados em um DataSet objeto e armazenados na memória no servidor. Isso permite cenários em que controles de interface do usuário, como GridView, oferecem recursos de classificação, filtragem e paginação.

Quando a DataSourceMode propriedade é definida como o valor, os DataReader dados são recuperados por um IDataReader objeto , que é um cursor somente encaminhamento, somente leitura. O tipo específico do IDataReader objeto depende do provedor de dados NET que o SqlDataSource usa, que é identificado pela ProviderName propriedade . Por padrão, o SqlDataSource controle usa o provedor para o Microsoft SQL Server, o System.Data.SqlCliente o leitor de dados é um SqlDataReader objeto .

Se você alterar a DataSourceMode propriedade, o DataSourceChanged evento será acionado, fazendo com que todos os controles associados ao SqlDataSource sejam reacopados.

O valor da DataSourceMode propriedade é armazenado no estado de exibição.

Aplica-se a

Confira também