Share via

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 引发异常。

适用于

另请参阅