SqlDataSource.DataSourceMode Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 hodnota DataSet .

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 prvku, 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 Když 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, ve kterých ovládací prvky uživatelského rozhraní, jako GridViewje , nabízejí možnosti řazení, filtrování a stránkování.

DataSourceMode Když je vlastnost nastavena na DataReader hodnotu, data jsou načtena objektemIDataReader, což je kurzor jen pro čtení. Konkrétní typ objektu IDataReader závisí na poskytovateli dat NET, kterého SqlDataSource používá, který je identifikovaný ProviderName vlastností. Ve výchozím nastavení SqlDataSource používá ovládací prvek zprostředkovatele pro Microsoft SQL Server, System.Data.SqlClientobjekt a čtečka SqlDataReader dat .

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

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

Platí pro