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