共用方式為

HtmlSelect.DataSourceID 屬性

  • 參考

定義

命名空間:
System.Web.UI.HtmlControls
組件:
System.Web.dll

取得或設定資料來源控制項的 ID 屬性，而 HtmlSelect 控制項應該用這個控制項來擷取其資料來源。

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

屬性值

String

指派給資料來源控制項的程式設計識別項。 預設值是空字串 ("")，表示尚未設定這個屬性。

例外狀況

HttpException

無法解析資料來源，因為同時為 DataSource 屬性和 DataSourceID 屬性指定了值。

範例

下列程式碼範例示範如何使用 DataSourceID 屬性來指定 控制項的 HtmlSelect 資料來源。 屬性 DataSourceID 會設定為 ID 用來擷取資料之控制項的 SqlDataSource 屬性。 載入頁面時， HtmlSelect 控制項會自動系結至控制項指定的 SqlDataSource 資料來源，並將資料顯示給使用者。

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

備註

DataSourceID使用 屬性來設定或存取 ID 控制項應該用來擷取其資料來源之資料來源控制項 HtmlSelect 的 屬性。 屬性所 DataSourceID 參考的資料來源控制項可以是實作 IDataSource 介面的任何控制項。 資料來源控制項必須存在於與參考資料源的控制項相同的命名容器 HtmlSelect 中，或在控制項的 HtmlSelect 父控制項中。 當您指定這個屬性的值時， HtmlSelect 控制項會自動系結至指定的資料來源控制項。 您不需要撰寫明確呼叫 方法的程式 DataBind 代碼。

或者，您可以使用 DataSource 屬性來指定要系結至 HtmlSelect 控制項的值來源。 資料來源必須是實作 System.Collections.IEnumerable 介面的集合 (，例如 System.Data.DataView 、 System.Collections.ArrayList 或 System.Collections.Generic.List<T>) 或 IListSource 介面。 當您設定 DataSource 屬性時，您必須手動撰寫程式碼來執行資料系結。

如果同時為 DataSource 屬性和 DataSourceID 屬性指定值，則 ASP.NET 無法解析資料來源，並 System.Web.HttpException 擲回例外狀況。

適用於

另請參閱