BaseDataList.DataSourceID 属性

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.dll

获取或设置数据源控件的 ID 属性，数据列表控件应使用它来检索其数据源。

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };

[System.Web.UI.Themeable(false)]
public virtual string DataSourceID { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.DataSourceID : string with get, set

Public Overridable Property DataSourceID As String

属性值

String

分配给数据源控件的编程标识符。

属性

ThemeableAttribute

例外

HttpException

无法解析数据源，因为对 DataSource 属性和 DataSourceID 属性指定了同一个值。

注解

DataSourceID使用属性访问ID数据列表控件应用于检索其数据源的数据源控件的属性。 属性引用的 DataSourceID 数据源控件可以是实现 IDataSource 接口的任何控件。 数据源控件必须存在于引用它的数据列表控件所在的同一命名容器中，或者存在于数据列表控件的父控件中。 为此属性指定值时，数据列表控件会自动绑定到指定的数据源控件。 无需编写显式调用 DataBind 该方法的代码。

或者，可以使用 DataSource 该属性指定值源以绑定到数据列表控件。 数据源必须是实现 System.Collections.IEnumerable 接口 (（例如 System.Data.DataView， System.Collections.ArrayList或 System.Collections.Generic.List<T>) 或 IListSource 接口）的集合，才能绑定到派生自类的 BaseDataList 控件。 设置 DataSource 属性时，必须手动编写代码来执行数据绑定。

如果为DataSource属性和DataSourceID属性指定了值，则 ASP.NET 无法解析数据源并System.Web.HttpException引发异常。

无法通过主题或样式表主题设置此属性。 有关详细信息，请参阅ThemeableAttribute和 ASP.NET 主题和外观。

另请参阅

• DataSource