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.Generic.List<T>) ）的集合System.Collections.IEnumerable，或者IListSource要绑定到从 类派生的控件的BaseDataList接口。 System.Collections.ArrayListSystem.Data.DataView 设置 DataSource 属性时，必须手动编写代码以执行数据绑定。

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

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

另请参阅

• DataSource