Sdílet prostřednictvím

SqlDataSourceMode Výčet

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Určuje, zda ovládací prvek SqlDataSource nebo AccessDataSource načte data jako IDataReader nebo DataSet.

public enum class SqlDataSourceMode
public enum SqlDataSourceMode
type SqlDataSourceMode = 
Public Enum SqlDataSourceMode
Dědičnost
Object
ValueType
Enum
SqlDataSourceMode

Pole

Name Hodnota Description
DataReader 0

Načte data z podkladového úložiště dat jako .IDataReader
DataSet 1

Načte data ze základního úložiště dat do DataSet struktury.

Příklady

Následující příklad ukazuje, jak nastavit DataSourceMode vlastnost SqlDataSource ovládacího prvku při DataReader načítání jednoduchého seznamu položek z databáze SQL Serveru do ListBox ovládacího prvku.

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

Následující příklad ukazuje, jak nastavit SqlDataSource.DataSourceMode vlastnost při DataSet načítání sady dat do GridView ovládacího prvku, který má povoleno řazení.

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

Poznámky

Výčet SqlDataSourceMode se používá SqlDataSource v ovládacích prvcích k AccessDataSource popisu režimu načítání dat, který ovládací prvek zdroje dat používá při Select zavolání metody. Pokud je vlastnost nastavena DataSourceMode na DataSet, data se načtou DataSet do struktury. To umožňuje scénáře, kdy ovládací prvky uživatelského rozhraní, jako GridView jsou možnosti řazení a stránkování. Pokud je vlastnost nastavena DataSourceMode na DataReader, data se načtou IDataReader objektem, což je jen pro čtení, kurzor jen pro čtení.

Výčet SqlDataSourceMode slouží pouze k popisu toho, jak Select příkaz načítá data; nemá žádný vliv na jiné operace SqlDataSource , které ovládací prvek provádí, například Insert, Updatenebo Delete.

Platí pro

Viz také