BaseDataList.DataSourceID Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

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

ThemeableAttribute

Exceptions

HttpException

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 soit dans le même conteneur de noms que le contrôle de liste de données qui le référence, soit 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 des 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 System.Data.DataViewexemple , System.Collections.ArrayListou System.Collections.Generic.List<T>) ou 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 la liaison de données.

Si des valeurs sont spécifiées pour la DataSource propriété et la 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 skins.

Voir aussi

• DataSource