Sdílet prostřednictvím

SqlDataSource.DataSourceMode Vlastnost

Definice

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

Získá nebo nastaví režim načítání dat, který SqlDataSource ovládací prvek používá k načtení dat.

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

Hodnota vlastnosti

SqlDataSourceMode

Jedna z SqlDataSourceMode hodnot. Výchozí hodnota je DataSet hodnota.

Výjimky

ArgumentOutOfRangeException

Vlastnost DataSourceMode není jednou z hodnot definovaných v objektu SqlDataSourceMode.

Příklady

Následující příklad kódu ukazuje, jak nastavit DataSourceMode vlastnost SqlDataSource ovládacího prvku na DataReader hodnotu pro scénář s ovládacím ListBox prvek, který nevyžaduje řazení, stránkování ani filtrování.

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

Poznámky

Režim načítání dat určuje, jak SqlDataSource ovládací prvek načítá data z podkladové databáze.

DataSourceMode Pokud je vlastnost nastavena DataSet na hodnotu, data jsou načtena do objektu DataSet a uložena v paměti na serveru. To umožňuje scénáře, kdy ovládací prvky uživatelského rozhraní, jako GridViewjsou možnosti řazení, filtrování a stránkování, nabízejí řazení, filtrování a stránkování.

DataSourceMode Pokud je vlastnost nastavena DataReader na hodnotu, data se načtou IDataReader objektem, což je kurzor jen pro čtení. Konkrétní typ objektu IDataReader závisí na zprostředkovateli dat NET, který SqlDataSource používá, který je identifikován vlastností ProviderName . Ve výchozím nastavení SqlDataSource ovládací prvek používá zprostředkovatele pro Microsoft SQL Server, a čtečka System.Data.SqlClientdat je SqlDataReader objekt.

Pokud vlastnost změníte DataSourceMode , DataSourceChanged vyvolá se událost, což způsobí všechny ovládací prvky, které jsou vázány na opětovné vazby SqlDataSource .

Hodnota DataSourceMode vlastnosti je uložena ve stavu zobrazení.

Platí pro

Viz také