BaseDataList.DataSourceID Właściwość

Definicja

Pobiera lub ustawia ID Właściwość kontrolki źródła danych, która powinna być używana przez formant wyświetlania danych w celu pobrania jego źródła danych.Gets or sets the ID property of the data source control that the data listing control should use to retrieve its data source.

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.The programmatic identifier assigned to the data source control.

Atrybuty

Wyjątki

Nie można rozpoznać źródła danych, ponieważ określono wartość DataSource właściwości i DataSourceID właściwości.The data source cannot be resolved because a value is specified for both the DataSource property and the DataSourceID property.

Uwagi

Użyj DataSourceID 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 formant wyświetlania danych w celu pobrania jego źródła danych.Use the DataSourceID property to access the ID property of the data source control that the data listing control should use to retrieve its data source. Formant źródła danych, do którego odwołuje się DataSourceID Właściwość, może być dowolną kontrolką implementującą IDataSource interfejs.The data source control referenced by the DataSourceID property can be any control that implements the IDataSource interface. Kontrolka źródła danych musi znajdować się w tym samym kontenerze nazw, co formant listy danych, który odwołuje się do niego lub w kontrolce nadrzędnej formantu listy danych.The data source control must exist either in the same naming container as the data listing control that references it, or in a parent control of the data listing control. Po określeniu wartości dla tej właściwości formant listy danych automatycznie wiąże się z określoną kontrolką źródła danych.When you specify a value for this property, the data listing control automatically binds to the specified data source control. Nie trzeba pisać kodu, który jawnie wywołuje DataBind metodę.You do not need to write code that explicitly calls the DataBind method.

Alternatywnie można użyć DataSource właściwości, aby określić źródło wartości do powiązania z formantem listy danych.Alternately, you can use the DataSource property to specify the source of values to bind to a data listing control. Źródło danych musi być kolekcją implementującą System.Collections.IEnumerable interfejs (taki jak System.Data.DataView , System.Collections.ArrayList lub System.Collections.Generic.List<T> ) lub interfejsem, który IListSource ma zostać powiązany z kontrolką pochodzącą od BaseDataList klasy.The data source must be a collection that implements the System.Collections.IEnumerable interface (such as System.Data.DataView, System.Collections.ArrayList, or System.Collections.Generic.List<T>) or the IListSource interface to bind to a control derived from the BaseDataList class. Podczas ustawiania DataSource właściwości należy ręcznie napisać kod w celu wykonania powiązania danych.When you set the DataSource property, you must manually write the code to perform data binding.

Jeśli dla DataSource właściwości i właściwości określono wartości DataSourceID , ASP.NET nie jest w stanie rozpoznać źródła danych, a System.Web.HttpException wyjątek jest zgłaszany.If values are specified for both the DataSource property and the DataSourceID property, ASP.NET is not able to resolve the data source and an System.Web.HttpException exception is thrown.

Tej właściwości nie można ustawić za pomocą motywów lub motywów arkuszy stylów.This property cannot be set by themes or style sheet themes. Aby uzyskać więcej informacji, zobacz temat ThemeableAttribute i ASP.NET motywy i karnacje.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Dotyczy

Zobacz też