Proprietà DataSourceMode

Proprietà SqlDataSource.DataSourceMode

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene o imposta la modalità di recupero dati utilizzata dal controllo SqlDataSource per recuperare dati.

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public SqlDataSourceMode DataSourceMode { get; set; }
/** @property */
public SqlDataSourceMode get_DataSourceMode ()

/** @property */
public void set_DataSourceMode (SqlDataSourceMode value)

public function get DataSourceMode () : SqlDataSourceMode

public function set DataSourceMode (value : SqlDataSourceMode)

Valore proprietà

Uno dei valori di SqlDataSourceMode. Il valore predefinito è il valore DataSet.

Tipo di eccezioneCondizione

ArgumentOutOfRangeException

La proprietà DataSourceMode non è uno dei valori definiti nell'oggetto SqlDataSourceMode.

La modalità di recupero dati identifica come un controllo SqlDataSource recupera dati da un database sottostante.

Quando la proprietà DataSourceMode viene impostata sul valore DataSet, i dati vengono caricati in uno oggetto DataSet e memorizzati nella memoria del server. Questo consente scenari in cui i controlli di interfaccia utente, ad esempio GridView, forniscono funzionalità di ordinamento, filtraggio e paging.

Quando la proprietà DataSourceMode viene impostata sul valore DataReader, i dati vengono recuperati da un oggetto IDataReader che è un cursore in sola lettura di tipo forward-only. Il tipo specifico dell'oggetto IDataReader dipende dal provider di dati NET utilizzato dall'oggetto SqlDataSource, che viene identificato dalla proprietà ProviderName. Per impostazione predefinita, il controllo SqlDataSource utilizza il provider per Microsoft SQL Server, vale a dire System.Data.SqlClient, e il visualizzatore di dati è un oggetto SqlDataReader.

Se viene modificata la proprietà DataSourceMode, viene generato l'evento DataSourceChanged con conseguente riassociazione di tutti i controlli associati a SqlDataSource.

Il valore della proprietà DataSourceMode è memorizzato in stato di visualizzazione.

Nell'esempio di codice riportato di seguito viene illustrato come impostare la proprietà DataSourceMode del controllo SqlDataSource sul valore DataReader per uno scenario con un controllo ListBox che non richiede alcun ordinamento, paging o filtraggio.

<%@ Page language="CS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM 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>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </FORM>
  </BODY>
</HTML>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2016 Microsoft