BaseDataList.DataSourceID 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定資料來源控制項的 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
屬性值
指派給資料來源控制項的程式設計識別項。
- 屬性
例外狀況
無法解析資料來源,因為同時為 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 主題和麵板。