SqlDataSource.DataSourceMode Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Datenabrufmodus ab, mit dem das SqlDataSource-Steuerelement Daten abruft, oder legt diesen fest.

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

SqlDataSourceMode

Einer der SqlDataSourceMode-Werte. Der Standardwert ist der DataSet-Wert.

Ausnahmen

ArgumentOutOfRangeException

Die DataSourceMode-Eigenschaft entspricht keinem der im SqlDataSourceMode angegebenen Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DataSourceMode Eigenschaft des SqlDataSource Steuerelements auf den DataReader Wert für ein Szenario mit einem ListBox Steuerelement festgelegt wird, das weder Sortierung, Paging noch Filterung erfordert.

<%@ 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 Datenabrufmodus gibt an, wie ein SqlDataSource Steuerelement Daten aus der zugrunde liegenden Datenbank abruft.

Wenn die DataSourceMode Eigenschaft auf den DataSet Wert festgelegt ist, werden Daten in ein DataSet Objekt geladen und im Arbeitsspeicher auf dem Server gespeichert. Dies ermöglicht Szenarien, in denen Benutzeroberflächensteuerelemente, z GridView. B. , Sortierungs-, Filter- und Pagingfunktionen bieten.

Wenn die DataSourceMode -Eigenschaft auf den DataReader Wert festgelegt ist, werden die Daten von einem IDataReader -Objekt abgerufen, bei dem es sich um einen schreibgeschützten Vorwärtscursor handelt. Der spezifische Typ des IDataReader Objekts hängt von dem NET-Datenanbieter ab, den der verwendet, der SqlDataSource durch die ProviderName -Eigenschaft identifiziert wird. Standardmäßig verwendet das SqlDataSource Steuerelement den Anbieter für Microsoft SQL Server, und System.Data.SqlClientder Datenleser ist ein SqlDataReader Objekt.

Wenn Sie die DataSourceMode -Eigenschaft ändern, wird das DataSourceChanged -Ereignis ausgelöst, wodurch alle Steuerelemente, die an die SqlDataSource gebunden sind, neu gebunden werden.

Der Wert der DataSourceMode Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für: