BaseDataList.DataSourceID Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Získá nebo nastaví ID vlastnost ovládacího prvku zdroje dat, který má ovládací prvek výpisu dat použít k načtení jeho zdroje dat.

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

Hodnota vlastnosti

String

Programový identifikátor přiřazený ke správě zdroje dat.

Atributy

ThemeableAttribute

Výjimky

HttpException

Zdroj dat nelze přeložit, protože je zadána hodnota pro DataSource vlastnost i DataSourceID vlastnost.

Poznámky

DataSourceID Vlastnost použijte pro přístup k ID vlastnosti ovládacího prvku zdroje dat, který má ovládací prvek výpisu dat použít k načtení jeho zdroje dat. Ovládací prvek zdroje dat odkazovaný vlastností DataSourceID může být libovolný ovládací prvek, který implementuje IDataSource rozhraní. Ovládací prvek zdroje dat musí existovat buď ve stejném kontejneru pojmenování jako ovládací prvek výpisu dat, který na něj odkazuje, nebo v nadřazené správě ovládacího prvku výpisu dat. Když zadáte hodnotu pro tuto vlastnost, ovládací prvek výpis dat automaticky vytvoří vazbu na zadaný ovládací prvek zdroje dat. Nemusíte psát kód, který explicitně volá metodu DataBind .

Alternativně můžete pomocí DataSource vlastnosti určit zdroj hodnot pro vytvoření vazby k ovládacímu prvku výpisu dat. Zdroj dat musí být kolekce, která implementuje System.Collections.IEnumerable rozhraní (například System.Data.DataView, System.Collections.ArrayListnebo ) nebo System.Collections.Generic.List<T>IListSource rozhraní pro vazbu na ovládací prvek odvozený z BaseDataList třídy. Při nastavování DataSource vlastnosti je nutné ručně napsat kód pro provedení datové vazby.

Pokud jsou pro vlastnost i DataSourceID vlastnost zadány DataSource hodnoty, ASP.NET nemůže přeložit zdroj dat a System.Web.HttpException vyvolá se výjimka.

Tuto vlastnost nelze nastavit motivy ani motivy šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Viz také

• DataSource