BaseDataList.DataSourceID Propriété

Définition

Obtient ou définit la propriété ID du contrôle de source de données que le contrôle de liste de données doit utiliser pour récupérer sa source de données.

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

Valeur de propriété

String

Identificateur programmatique assigné au contrôle de source de données.

Attributs

Exceptions

La source de données ne peut pas être déterminée, car une valeur est spécifiée à la fois pour la propriété DataSource et pour la propriété DataSourceID.

Remarques

Utilisez la DataSourceID propriété pour accéder à la ID propriété du contrôle de source de données que le contrôle de liste de données doit utiliser pour récupérer sa source de données. Le contrôle de source de données référencé par la DataSourceID propriété peut être n’importe quel contrôle qui implémente l’interface IDataSource . Le contrôle de source de données doit exister dans le même conteneur d’affectation de noms que le contrôle de liste de données qui le référence, ou dans un contrôle parent du contrôle de liste de données. Lorsque vous spécifiez une valeur pour cette propriété, le contrôle de liste de données se lie automatiquement au contrôle de source de données spécifié. Vous n’avez pas besoin d’écrire du code qui appelle explicitement la DataBind méthode.

Vous pouvez également utiliser la DataSource propriété pour spécifier la source de valeurs à lier à un contrôle de liste de données. La source de données doit être une collection qui implémente l’interface System.Collections.IEnumerable (par exemple System.Data.DataView, System.Collections.ArrayListou ) ou System.Collections.Generic.List<T>l’interface IListSource à lier à un contrôle dérivé de la BaseDataList classe. Lorsque vous définissez la DataSource propriété, vous devez écrire manuellement le code pour effectuer une liaison de données.

Si les valeurs sont spécifiées pour la propriété et la DataSource DataSourceID propriété, ASP.NET n’est pas en mesure de résoudre la source de données et une System.Web.HttpException exception est levée.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et peaux.

S’applique à

Voir aussi