Sdílet prostřednictvím

SqlDataSource.DataSourceMode Vlastnost

  • Reference

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

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 k objektu SqlDataSource , se znovu zaváže.

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

Platí pro

Viz také