Teilen über

SqlDataSourceMode Enumeration

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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:

Weitere Informationen