SqlDataSourceMode Enumeration

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.

Gibt an, ob ein SqlDataSource-Steuerelement oder ein AccessDataSource-Steuerelement Daten als IDataReader oder DataSet abruft.

public enum class SqlDataSourceMode

public enum SqlDataSourceMode

type SqlDataSourceMode =

Public Enum SqlDataSourceMode

Vererbung: Object

ValueType

Enum
SqlDataSourceMode

Felder

DataReader	0	Ruft Daten aus dem zugrunde liegenden Datenspeicher als ab IDataReader.
DataSet	1	Ruft Daten aus dem zugrunde liegenden Datenspeicher in eine DataSet-Struktur ab.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die DataSourceMode -Eigenschaft eines SqlDataSource Steuerelements auf DataReader festgelegt wird, wenn eine einfache Liste von Elementen aus einer SQL Server-Datenbank in ein ListBox Steuerelement abgerufen wird.

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

Im folgenden Beispiel wird veranschaulicht, wie die SqlDataSource.DataSourceMode -Eigenschaft auf DataSet festgelegt wird, wenn eine Gruppe von Daten in einem GridView Steuerelement abgerufen wird, für das die Sortierung aktiviert ist.

<!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>

<!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>

Hinweise

Die SqlDataSourceMode -Enumeration wird von den Steuerelementen SqlDataSource und AccessDataSource verwendet, um den Datenabrufmodus zu beschreiben, den das Datenquellensteuerelement beim Aufrufen der Select -Methode verwendet. Wenn die DataSourceMode -Eigenschaft auf DataSetfestgelegt ist, werden Daten in eine DataSet -Struktur geladen. Dies ermöglicht Szenarien, in denen Benutzeroberflächensteuerelemente wie GridView Sortier- und Pagingfunktionen anbieten. Wenn die DataSourceMode -Eigenschaft auf DataReaderfestgelegt ist, werden Daten von einem IDataReader -Objekt abgerufen, bei dem es sich um einen schreibgeschützten Vorwärtscursor handelt.

Die SqlDataSourceMode -Enumeration wird nur verwendet, um zu beschreiben, wie der Select Befehl Daten abruft. Sie hat keine Auswirkungen auf andere Vorgänge, die das SqlDataSource Steuerelement ausführt, z Insert. B. , Updateoder Delete.

Gilt für:

Freigeben über