SqlDataSource.DataSourceMode Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimin verileri getirmek için kullandığı veri alma modunu SqlDataSource alır veya ayarlar.

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

Özellik Değeri

SqlDataSourceMode

Değerlerden SqlDataSourceMode biri. Varsayılan değerdir DataSet .

Özel durumlar

ArgumentOutOfRangeException

DataSourceMode özelliği içinde tanımlanan SqlDataSourceModedeğerlerden biri değildir.

Örnekler

Aşağıdaki kod örneği sıralama, sayfalama veya filtreleme gerektirmeyen bir denetime DataReader sahip bir ListBox senaryo için denetimin özelliğinin SqlDataSource değerine nasıl ayarlanacağını DataSourceMode gösterir.

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

Açıklamalar

Veri alma modu, bir SqlDataSource denetimin temel alınan veritabanından verileri nasıl aldırıyor olduğunu tanımlar.

DataSourceMode özelliği değerine ayarlandığındaDataSet, veriler bir DataSet nesneye yüklenir ve sunucudaki bellekte depolanır. Bu, gibi GridViewkullanıcı arabirimi denetimlerinin sıralama, filtreleme ve sayfalama özellikleri sunduğu senaryoları etkinleştirir.

DataSourceMode özelliği değerine ayarlandığındaDataReader, veriler yalnızca ileriye dönük, salt okunur bir imleç olan bir IDataReader nesne tarafından alınır. Nesnenin IDataReader belirli türü, özelliği tarafından tanımlanan, kullandığı SqlDataSource NET veri sağlayıcısına ProviderName bağlıdır. Varsayılan olarak, SqlDataSource denetim Microsoft SQL Server sağlayıcısını System.Data.SqlClientkullanır ve veri okuyucu bir SqlDataReader nesnedir.

özelliğini değiştirirseniz DataSourceMode olayı DataSourceChanged tetiklenir ve öğesine bağlı SqlDataSource tüm denetimlerin yeniden bağlanmasına neden olur.

özelliğinin DataSourceMode değeri görünüm durumunda depolanır.

Şunlara uygulanır

Ayrıca bkz.