Bagikan melalui

HtmlSelect.DataSourceID Properti

Definisi

Ruang nama:
System.Web.UI.HtmlControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur ID properti kontrol sumber data yang HtmlSelect harus digunakan kontrol untuk mengambil sumber datanya.

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataSourceID { get; set; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

Nilai Properti

String

Pengidentifikasi terprogram yang ditetapkan ke kontrol sumber data. Nilai default adalah string kosong (""), yang menunjukkan bahwa properti belum diatur.

Pengecualian

HttpException

Sumber data tidak dapat diselesaikan karena nilai ditentukan untuk DataSource properti dan DataSourceID properti .

Contoh

Contoh kode berikut menunjukkan cara menggunakan DataSourceID properti untuk menentukan sumber data untuk HtmlSelect kontrol. Properti DataSourceID diatur ke ID properti kontrol yang SqlDataSource digunakan untuk mengambil data. Saat halaman dimuat, HtmlSelect kontrol secara otomatis mengikat ke sumber data yang ditentukan oleh SqlDataSource kontrol dan data ditampilkan kepada pengguna.

<%@ 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 id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</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 id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</form>
</body>
</html>

Keterangan

DataSourceID Gunakan properti untuk mengatur atau mengakses ID properti kontrol sumber data yang HtmlSelect harus digunakan kontrol untuk mengambil sumber datanya. Kontrol sumber data yang dirujuk DataSourceID oleh properti dapat menjadi kontrol apa pun yang mengimplementasikan IDataSource antarmuka. Kontrol sumber data harus ada dalam kontainer penamaan yang sama dengan HtmlSelect kontrol yang mereferensikannya atau dalam kontrol HtmlSelect induk kontrol. Saat Anda menentukan nilai untuk properti ini, HtmlSelect kontrol secara otomatis mengikat kontrol sumber data yang ditentukan. Anda tidak perlu menulis kode yang secara eksplisit memanggil DataBind metode .

Secara bergantian, Anda dapat menggunakan DataSource properti untuk menentukan sumber nilai yang akan diikat ke HtmlSelect kontrol. Sumber data harus berupa koleksi yang mengimplementasikan System.Collections.IEnumerable antarmuka (seperti System.Data.DataView, , System.Collections.ArrayListatau System.Collections.Generic.List<T>) atau IListSource antarmuka. Saat mengatur DataSource properti, Anda harus menulis kode secara manual untuk melakukan pengikatan data.

Jika nilai ditentukan untuk DataSource properti dan DataSourceID properti , ASP.NET tidak dapat menyelesaikan sumber data dan System.Web.HttpException pengecualian dilemparkan.

Berlaku untuk

Lihat juga