BaseDataList.DataSourceID Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.dll

Pobiera lub ustawia ID właściwość kontrolki źródła danych, która powinna być używana przez kontrolkę listy danych w celu pobrania ź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

ThemeableAttribute

Wyjątki

HttpException

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

Uwagi

DataSourceID Użyj właściwości , aby uzyskać dostęp do ID właściwości kontrolki źródła danych, która powinna być używana przez kontrolkę listy danych w celu pobrania źródła danych. Kontrolka źródła danych, do którego odwołuje się właściwość, może być dowolną DataSourceID kontrolką implementaną interfejsu IDataSource . Kontrolka ź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 trzeba pisać kodu, który jawnie wywołuje metodę DataBind .

Alternatywnie możesz 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ą BaseDataList z 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 może rozpoznać źródła danych i System.Web.HttpException zgłaszany jest wyjątek.

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skórki.

Zobacz też

• DataSource