SqlDataSource.DataSourceMode Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia tryb pobierania danych używany przez kontrolkę SqlDataSource do pobierania danych.

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

Wartość właściwości

SqlDataSourceMode

SqlDataSourceMode Jedna z wartości. Wartość domyślna DataSet to .

Wyjątki

ArgumentOutOfRangeException

Właściwość DataSourceMode nie jest jedną z wartości zdefiniowanych w obiekcie SqlDataSourceMode.

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić DataSourceMode właściwość kontrolki SqlDataSource na DataReader wartość scenariusza z kontrolką ListBox , która nie wymaga sortowania, stronicowania ani filtrowania.

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

Uwagi

Tryb pobierania danych określa, w jaki sposób kontrolka SqlDataSource pobiera dane z bazowej bazy danych.

Gdy właściwość jest ustawiona DataSourceModeDataSet na wartość, dane są ładowane do DataSet obiektu i przechowywane w pamięci na serwerze. Umożliwia to scenariusze, w których kontrolki interfejsu użytkownika, takie jak GridView, oferują funkcje sortowania, filtrowania i stronicowania.

DataSourceMode Gdy właściwość jest ustawiona DataReader na wartość, dane są pobierane przez IDataReader obiekt, który jest kursorem tylko do przodu, tylko do odczytu. Określony typ IDataReader obiektu zależy od dostawcy danych NET, którego SqlDataSource używa, który jest identyfikowany przez ProviderName właściwość . Domyślnie kontrolka SqlDataSource używa dostawcy dla usługi Microsoft SQL Server, System.Data.SqlClienta czytnik danych jest obiektemSqlDataReader.

Jeśli zmienisz DataSourceMode właściwość, DataSourceChanged zostanie zgłoszone zdarzenie, co spowoduje ponowne powiązanie wszystkich kontrolek powiązanych z elementem SqlDataSource .

Wartość DataSourceMode właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też