SqlDataSourceMode SqlDataSourceMode SqlDataSourceMode SqlDataSourceMode Enum

Definition

Gibt an, ob ein SqlDataSource-Steuerelement oder ein AccessDataSource-Steuerelement Daten als IDataReader oder DataSet abruft.Specifies whether a SqlDataSource or AccessDataSource control retrieves data as a IDataReader or DataSet.

public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode = 
Public Enum SqlDataSourceMode
Vererbung
SqlDataSourceModeSqlDataSourceModeSqlDataSourceModeSqlDataSourceMode

Felder

DataReader DataReader DataReader DataReader 0

Ruft Daten aus dem zugrunde liegenden Datenspeicher als IDataReader ab.Retrieves data from the underlying data storage as an IDataReader

DataSet DataSet DataSet DataSet 1

Ruft Daten aus dem zugrunde liegenden Datenspeicher in eine DataSet-Struktur ab.Retrieves data from the underlying data storage into a DataSet structure.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die DataSourceMode -Eigenschaft SqlDataSource eines-Steuer DataReader Elements auf festgelegt wird, wenn eine einfache Liste von Elementen aus einer ListBox SQL Server-Datenbank in ein-Steuerelement abgerufen wird.The following example demonstrates how to set the DataSourceMode property of a SqlDataSource control to DataReader when retrieving a simple list of items from a SQL Server database into a ListBox control.

<%@ 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 DataSet auf festgelegt wird, wenn ein Satz von GridView Daten in ein Steuerelement abgerufen wird, für das die Sortierung aktiviert ist.The following example demonstrates how to set the SqlDataSource.DataSourceMode property to DataSet when retrieving a set of data into a GridView control that has sorting enabled.

<!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 SqlDataSource Steuer AccessDataSource Elementen und verwendet, um den Datenabruf Modus zu beschreiben, den das Daten Select Quellen-Steuerelement verwendet, wenn die-Methode aufgerufen wird.The SqlDataSourceMode enumeration is used by the SqlDataSource and AccessDataSource controls to describe the data retrieval mode that the data source control uses when the Select method is called. Wenn die DataSourceMode -Eigenschaft auf DataSetfestgelegt ist, werden Daten in DataSet eine-Struktur geladen.When the DataSourceMode property is set to DataSet, data is loaded into a DataSet structure. Dies ermöglicht Szenarien, in denen Steuerelemente der GridView Benutzeroberfläche z. b. Sortier-und Pagingfunktionen bieten.This enables scenarios where user interface controls such as GridView offer sorting and paging capabilities. Wenn die DataSourceMode -Eigenschaft auf DataReaderfestgelegt ist, werden die Daten IDataReader von einem-Objekt abgerufen, bei dem es sich um einen schreibgeschützten Vorwärts Cursor handelt.When the DataSourceMode property is set to DataReader, data is retrieved by an IDataReader object, which is a read-only, forward-only cursor.

Die SqlDataSourceMode -Enumeration wird nur verwendet, um zu Select beschreiben, wie der Befehl Daten abruft. Sie wirkt sich nicht SqlDataSource auf andere Vorgänge aus, die Updatedas Steuer DeleteElement ausführt, z Insert. b., oder.The SqlDataSourceMode enumeration is only used to describe how the Select command retrieves data; it has no effect on other operations the SqlDataSource control performs, such as Insert, Update, or Delete.

Gilt für:

Siehe auch