SqlDataSource.DataSourceMode Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o modo de recuperação de dados que o SqlDataSource controlo usa para obter 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 de Propriedade

SqlDataSourceMode

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

Exceções

ArgumentOutOfRangeException

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

Exemplos

O exemplo de código seguinte demonstra como definir a DataSourceMode propriedade do SqlDataSource controlo para o DataReader valor de um cenário com um ListBox controlo que não requer ordenaçã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>

Observações

O modo de recuperação de dados identifica como um SqlDataSource controlo recupera dados da base de dados subjacente.

Quando a DataSourceMode propriedade é definida para o DataSet valor, os dados são carregados num DataSet objeto e armazenados na memória do servidor. Isto permite cenários em que os controlos da interface do utilizador, como GridView, oferecem capacidades de ordenação, filtragem e paginação.

Quando a DataSourceMode propriedade é definida para o DataReader valor, os dados são recuperados por um IDataReader objeto, que é um cursor apenas para frente, só leitura. O tipo específico do IDataReader objeto depende do fornecedor de dados NET que utiliza SqlDataSource , que é identificado pela ProviderName propriedade. Por defeito, o controlo SqlDataSource usa o fornecedor para Microsoft SQL Server, o System.Data.SqlClient, e o leitor de dados é um objeto SqlDataReader.

Se mudares a DataSourceMode propriedade, o DataSourceChanged evento é ativado, fazendo com que quaisquer controlos ligados ao SqlDataSource se reassociem.

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

Aplica-se a

Ver também