SqlDataSource.DataSourceMode Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

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

Valore della proprietà

SqlDataSourceMode

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

Eccezioni

ArgumentOutOfRangeException

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

Esempio

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

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

Commenti

La modalità di recupero dei dati identifica il modo in cui un SqlDataSource controllo recupera i dati dal database sottostante.

Quando la proprietà è impostata sul DataSet valore, i DataSourceMode dati vengono caricati in un DataSet oggetto e archiviati in memoria nel server. Ciò consente scenari in cui i controlli dell'interfaccia utente, ad esempio GridView, offrono l'ordinamento, il filtro e le funzionalità di paging.

Quando la proprietà è impostata sul DataReader valore, i DataSourceMode dati vengono recuperati da un oggetto, ovvero un IDataReader cursore di sola lettura. Il tipo specifico dell'oggetto IDataReader dipende dal provider di dati NET usato SqlDataSource , identificato dalla ProviderName proprietà . Per impostazione predefinita, il SqlDataSource controllo usa il provider per Microsoft SQL Server, e il System.Data.SqlClientlettore di dati è un SqlDataReader oggetto.

Se si modifica la proprietà, l'evento DataSourceModeDataSourceChanged viene generato, causando eventuali controlli associati all'oggetto SqlDataSource da associare.

Il valore della proprietà viene archiviato nello stato di DataSourceMode visualizzazione.

Si applica a

Vedi anche