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ý by měl ovládací prvek výpisu dat použít k načtení 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ý ovládacímu prvku zdroje dat.

Atributy

ThemeableAttribute

Výjimky

HttpException

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

Poznámky

DataSourceID Vlastnost použijte pro přístup ID k vlastnosti ovládacího prvku zdroje dat, který by měl ovládací prvek výpisu dat použít k načtení zdroje dat. Ovládací prvek zdroje dat odkazovaný DataSourceID vlastností může být libovolný ovládací prvek, který implementuje IDataSource rozhraní. Ovládací prvek zdroje dat musí existovat buď ve stejném kontejneru názvů jako ovládací prvek výpisu dat, který na něj odkazuje, nebo v nadřazené ovládací prvek ovládacího prvku výpisu dat. Pokud zadáte hodnotu pro tuto vlastnost, ovládací prvek výpisu 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 použít DataSource vlastnost k určení zdroje hodnot, které se mají svázat s ovládacím prvku výpisu dat. Zdrojem dat musí být kolekce, která implementuje rozhraní (například , nebo ) nebo IListSource rozhraní pro vytvoření vazby System.Collections.IEnumerable na ovládací prvek odvozený z BaseDataList třídy .System.Collections.Generic.List<T>System.Collections.ArrayListSystem.Data.DataView Při nastavování DataSource vlastnosti je nutné ručně napsat kód pro provedení datové vazby.

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

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

Viz také

• DataSource