SqlDataSource.DataSourceMode Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur mode pengambilan data yang SqlDataSource digunakan kontrol untuk mengambil data.

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

Nilai Properti

SqlDataSourceMode

Salah SqlDataSourceMode satu nilai. Defaultnya adalah nilainya DataSet .

Pengecualian

ArgumentOutOfRangeException

Properti DataSourceMode bukan salah satu nilai yang ditentukan dalam SqlDataSourceMode.

Contoh

Contoh kode berikut menunjukkan cara mengatur DataSourceMode properti kontrol ke DataReader nilai untuk skenario dengan ListBox kontrol yang tidak memerlukan pengurutan, penomoran, atau pemfilteranSqlDataSource.

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

Keterangan

Mode pengambilan data mengidentifikasi bagaimana SqlDataSource kontrol mengambil data dari database yang mendasar.

DataSourceMode Ketika properti diatur ke DataSet nilai , data dimuat ke dalam DataSet objek dan disimpan dalam memori di server. Ini memungkinkan skenario di mana kontrol antarmuka pengguna, seperti GridView, menawarkan kemampuan pengurutan, pemfilteran, dan penomoran halaman.

DataSourceMode Saat properti diatur ke DataReader nilai , data diambil oleh IDataReader objek, yang merupakan kursor baca-saja dan hanya-teruskan. Jenis IDataReader objek tertentu tergantung pada penyedia data NET yang SqlDataSource digunakan, yang diidentifikasi oleh ProviderName properti . Secara default, SqlDataSource kontrol menggunakan penyedia untuk Microsoft SQL Server, System.Data.SqlClient, dan pembaca data adalah SqlDataReader objek.

Jika Anda mengubah DataSourceMode properti , DataSourceChanged peristiwa dinaikkan, menyebabkan kontrol apa pun yang terikat ke SqlDataSource pengikatan ulang.

Nilai DataSourceMode properti disimpan dalam status tampilan.

Berlaku untuk

Bagikan melalui