BaseDataList.DataSourceID Właściwość

Definicja

Pobiera lub ustawia ID właściwość kontrolki źródła danych, której kontrolka listy danych powinna używać do pobierania źródła danych.

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

Wartość właściwości

String

Identyfikator programowy przypisany do kontroli źródła danych.

Atrybuty

Wyjątki

Nie można rozpoznać źródła danych, ponieważ wartość jest określona zarówno DataSource dla właściwości, jak i DataSourceID właściwości.

Uwagi

Użyj właściwości , DataSourceID aby uzyskać dostęp do ID właściwości kontrolki źródła danych, której kontrolka listy danych powinna użyć do pobrania źródła danych. Kontrolka źródła danych, do której DataSourceID odwołuje się właściwość, może być dowolną kontrolką IDataSource , która implementuje interfejs. Kontrola źródła danych musi istnieć w tym samym kontenerze nazewnictwa co kontrolka listy danych odwołującej się do niego lub w nadrzędnej kontrolce kontrolki listy danych. Po określeniu wartości tej właściwości kontrolka listy danych automatycznie wiąże się z określoną kontrolą źródła danych. Nie musisz pisać kodu, który jawnie wywołuje metodę DataBind .

Alternatywnie można użyć DataSource właściwości , aby określić źródło wartości do powiązania z kontrolką listy danych. Źródło danych musi być kolekcją, która implementuje System.Collections.IEnumerable interfejs (taki jak System.Data.DataView, System.Collections.ArrayListlub System.Collections.Generic.List<T>) lub IListSource interfejs do powiązania z kontrolką pochodzącą z BaseDataList klasy. Po ustawieniu DataSource właściwości należy ręcznie napisać kod, aby wykonać powiązanie danych.

Jeśli wartości są określone zarówno DataSource dla właściwości, jak i DataSourceID właściwości, ASP.NET nie jest w stanie rozpoznać źródła danych i System.Web.HttpException zgłaszany jest wyjątek.

Nie można ustawić tej właściwości według motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttribute i ASP.NET Motywy i skóry.

Dotyczy

Zobacz też