SqlDataSource.DataSourceMode Eigenschaft

Definition

Ruft den Datenabrufmodus ab, mit dem das SqlDataSource-Steuerelement Daten abruft, oder legt diesen fest.Gets or sets the data retrieval mode that the SqlDataSource control uses to fetch data.

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

Eigenschaftswert

Einer der SqlDataSourceMode-Werte.One of the SqlDataSourceMode values. Der Standardwert ist DataSet der-Wert.The default is the DataSet value.

Ausnahmen

Die DataSourceMode-Eigenschaft entspricht keinem der im SqlDataSourceMode angegebenen Werte.The DataSourceMode property is not one of the values defined in the SqlDataSourceMode.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DataSourceMode -Eigenschaft SqlDataSource des-Steuer Elements DataReader auf den Wert für ein Szenario ListBox mit einem-Steuerelement festgelegt wird, das keine Sortierung, Auslagerung und Filterung erfordert.The following code example demonstrates how to set the DataSourceMode property of the SqlDataSource control to the DataReader value for a scenario with a ListBox control that requires no sorting, paging, nor filtering.

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

Hinweise

Der Datenabruf Modus gibt an, SqlDataSource wie ein-Steuerelement Daten aus der zugrunde liegenden Datenbank abruft.The data retrieval mode identifies how a SqlDataSource control retrieves data from the underlying database.

Wenn die DataSourceMode -Eigenschaft auf den DataSet -Wert festgelegt ist, werden Daten DataSet in ein-Objekt geladen und im Arbeitsspeicher auf dem Server gespeichert.When the DataSourceMode property is set to the DataSet value, data is loaded into a DataSet object and stored in memory on the server. Dies ermöglicht Szenarien, in denen Steuerelemente der Benutzer GridViewOberfläche wie z. b. Sortier-, Filter-und Pagingfunktionen bieten.This enables scenarios where user interface controls, such as GridView, offer sorting, filtering, and paging capabilities.

Wenn die DataSourceMode -Eigenschaft auf den DataReader -Wert festgelegt ist, werden die IDataReader Daten von einem-Objekt abgerufen, bei dem es sich um einen schreibgeschützten Vorwärts Cursor handelt.When the DataSourceMode property is set to the DataReader value, data is retrieved by a IDataReader object, which is a forward-only, read-only cursor. Der spezifische Objekttyp IDataReader hängt von dem von der SqlDataSource verwendeten NET-Datenanbieter ab, der durch die ProviderName -Eigenschaft identifiziert wird.The specific type of the IDataReader object depends on the NET data provider that the SqlDataSource uses, which is identified by the ProviderName property. Standardmäßig verwendet das SqlDataSource -Steuerelement den-Anbieter für Microsoft SQL Server System.Data.SqlClient,, und der Daten Reader ist SqlDataReader ein-Objekt.By default, the SqlDataSource control uses the provider for Microsoft SQL Server, the System.Data.SqlClient, and the data reader is a SqlDataReader object.

Wenn Sie die DataSourceMode -Eigenschaft ändern, DataSourceChanged wird das-Ereignis ausgelöst und bewirkt, SqlDataSource dass alle Steuerelemente, die an gebunden sind, erneut gebunden werden.If you change the DataSourceMode property, the DataSourceChanged event is raised, causing any controls that are bound to the SqlDataSource to rebind.

Der Wert DataSourceMode der Eigenschaft wird im Ansichts Zustand gespeichert.The value of the DataSourceMode property is stored in view state.

Gilt für:

Siehe auch