SqlDataSourceMode Enumerazione

Definizione

Specifica se un controllo SqlDataSource o AccessDataSource recupera i dati come IDataReader o DataSet.

public enum SqlDataSourceMode
Ereditarietà
SqlDataSourceMode

Campi

DataReader 0

Recupera i dati dall'archivio dati sottostante come .IDataReader

DataSet 1

Recupera i dati dall'archivio dati sottostante in una struttura DataSet.

Esempio

Nell'esempio seguente viene illustrato come impostare la DataSourceMode proprietà di un SqlDataSource controllo su DataReader quando si recupera un semplice elenco di elementi da un database SQL Server in un ListBox controllo .

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

Nell'esempio seguente viene illustrato come impostare la SqlDataSource.DataSourceMode proprietà su DataSet quando si recupera un set di dati in un GridView controllo con l'ordinamento abilitato.

<!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="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Commenti

L'enumerazione SqlDataSourceMode viene utilizzata dai SqlDataSource controlli e AccessDataSource per descrivere la modalità di recupero dei dati utilizzata dal controllo origine dati quando viene chiamato il Select metodo . Quando la proprietà è impostata su DataSet, i DataSourceMode dati vengono caricati in una DataSet struttura. Ciò consente scenari in cui i controlli dell'interfaccia utente, ad GridView esempio l'ordinamento e le funzionalità di paging. Quando la DataSourceMode proprietà è impostata su DataReader, i dati vengono recuperati da un IDataReader oggetto , ovvero un cursore forward-only di sola lettura.

L'enumerazione SqlDataSourceMode viene usata solo per descrivere il modo in cui il Select comando recupera i dati. Non ha alcun effetto sulle altre operazioni eseguite dal SqlDataSource controllo, ad esempio Insert, Updateo Delete.

Si applica a

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Vedi anche