Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
DataBoundControl, classe
Sert de classe de base pour tous les contrôles liés aux données de la version 2.0 d'ASP.NET qui affichent leurs données sous forme de liste ou de tableau.
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.BaseDataBoundControl
System.Web.UI.WebControls.DataBoundControl
System.Web.UI.DataVisualization.Charting.Chart
System.Web.UI.WebControls.AdRotator
System.Web.UI.WebControls.CompositeDataBoundControl
System.Web.UI.WebControls.ListControl
System.Web.UI.WebControls.ListView
Assembly : System.Web (dans System.Web.dll)
Le type DataBoundControl expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DataBoundControl | Initialise la classe DataBoundControl pour qu'elle soit utilisée par une instance de classe héritée. Ce constructeur peut être appelé uniquement par une classe héritée. |
| Nom | Description | |
|---|---|---|
|
AccessKey | Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web. (Hérité de WebControl.) |
|
Adapter | Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control.) |
|
AppRelativeTemplateSourceDirectory | Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control.) |
|
Attributes | Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle. (Hérité de WebControl.) |
|
BackColor | Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web. (Hérité de WebControl.) |
|
BindingContainer | Infrastructure. Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control.) |
|
BorderColor | Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl.) |
|
BorderStyle | Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl.) |
|
BorderWidth | Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl.) |
|
ChildControlsCreated | Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control.) |
|
ClientID | Obtient l'ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control.) |
|
ClientIDMode | Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control.) |
|
ClientIDSeparator | Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control.) |
|
Context | Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control.) |
|
Controls | Obtient un objet ControlCollection qui représente les contrôles enfants d'un contrôle serveur spécifié dans la hiérarchie de l'interface utilisateur. (Hérité de Control.) |
|
ControlStyle | Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
ControlStyleCreated | Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
CssClass | Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl.) |
|
DataItemContainer | Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control.) |
|
DataKeysContainer | Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control.) |
|
DataMember | Obtient ou définit le nom de la liste des données auxquelles le contrôle lié aux données se lie, dans les cas où la source de données contient plusieurs listes distinctes d'éléments de données. |
|
DataSource | Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Hérité de BaseDataBoundControl.) |
|
DataSourceID | Obtient ou définit l'ID du contrôle duquel le contrôle lié aux données récupère sa liste d'éléments de données. (Substitue BaseDataBoundControl.DataSourceID.) |
|
DataSourceObject | Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet. |
|
DesignMode | Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control.) |
|
Enabled | Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl.) |
|
EnableTheming | Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de WebControl.) |
|
EnableViewState | Obtient ou définit une valeur indiquant si le contrôle serveur rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande. (Hérité de Control.) |
|
Events | Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control.) |
|
Font | Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl.) |
|
ForeColor | Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl.) |
|
HasAttributes | Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl.) |
|
HasChildViewState | Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control.) |
|
Height | Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl.) |
|
ID | Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control.) |
|
IdSeparator | Infrastructure. Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control.) |
|
Initialized | Obtient une valeur indiquant si le contrôle lié aux données a été initialisé. (Hérité de BaseDataBoundControl.) |
|
IsBoundUsingDataSourceID | Obtient une valeur indiquant si la propriété DataSourceID est définie. (Hérité de BaseDataBoundControl.) |
|
IsChildControlStateCleared | Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control.) |
|
IsEnabled | Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl.) |
|
IsTrackingViewState | Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control.) |
|
IsViewStateEnabled | Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control.) |
|
LoadViewStateByID | Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control.) |
|
NamingContainer | Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété Control.ID possède la même valeur. (Hérité de Control.) |
|
Page | Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control.) |
|
Parent | Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control.) |
|
RenderingCompatibility | Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control.) |
|
RequiresDataBinding | Obtient ou définit une valeur indiquant si la méthode DataBind doit être appelée. (Hérité de BaseDataBoundControl.) |
|
SelectArguments | Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données à partir d'un contrôle de source de données. |
|
Site | Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control.) |
|
SkinID | Obtient ou définit l'apparence à appliquer au contrôle. (Hérité de WebControl.) |
|
Style | Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web. (Hérité de WebControl.) |
|
SupportsDisabledAttribute | Obtient une valeur qui indique si le contrôle doit affecter à l'attribut disabled de l'élément HTML rendu la valeur "disabled" lorsque la propriété IsEnabled du contrôle a la valeur false. (Hérité de BaseDataBoundControl.) |
|
TabIndex | Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl.) |
|
TagKey | Obtient la valeur HtmlTextWriterTag qui correspond au contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
TagName | Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
TemplateControl | Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control.) |
|
TemplateSourceDirectory | Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control.) |
|
ToolTip | Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web. (Hérité de WebControl.) |
|
UniqueID | Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control.) |
|
ViewState | Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control.) |
|
ViewStateIgnoresCase | Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control.) |
|
ViewStateMode | Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control.) |
|
Visible | Obtient ou définit une valeur qui indique si un contrôle serveur est rendu sous la forme d'une interface utilisateur sur la page. (Hérité de Control.) |
|
Width | Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl.) |
| Nom | Description | |
|---|---|---|
|
AddAttributesToRender | Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
AddedControl | Appelée après l'ajout d'un contrôle enfant à la collection Controls de l'objet Control. (Hérité de Control.) |
|
AddParsedSubObject | Avertit le contrôle serveur qu'un élément XML ou HTML a été analysé et l'ajoute à l'objet ControlCollection du contrôle serveur. (Hérité de Control.) |
|
ApplyStyle | Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
ApplyStyleSheetSkin | Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control.) |
|
BuildProfileTree | Infrastructure. Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control.) |
|
ClearCachedClientID | Infrastructure. Affecte à la valeur ClientID mise en cache la valeur null. (Hérité de Control.) |
|
ClearChildControlState | Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
ClearChildState | Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
ClearChildViewState | Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
ClearEffectiveClientIDMode | Infrastructure. Affecte la valeur Inherit à la propriété ClientIDMode de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control.) |
|
ConfirmInitState | Définit l'état initialisé du contrôle lié aux données. (Hérité de BaseDataBoundControl.) |
|
CopyBaseAttributes | Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
CreateChildControls | Appelé par l'infrastructure de page ASP.NET pour avertir les contrôles serveur qui utilisent une implémentation basée sur la composition qu'ils doivent créer tous les contrôles enfants qu'ils contiennent en préparation de la publication ou du rendu. (Hérité de Control.) |
|
CreateControlCollection | Crée un nouvel objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control.) |
|
CreateControlStyle | Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
CreateDataSourceSelectArguments | Crée un objet DataSourceSelectArguments par défaut utilisé par le contrôle lié aux données si aucun argument n'est spécifié. |
|
DataBind() | Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de BaseDataBoundControl.) |
|
DataBind(Boolean) | Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control.) |
|
DataBindChildren | Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control.) |
|
Dispose | Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control.) |
|
EnsureChildControls | Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control.) |
|
EnsureDataBound | Appelle la méthode DataBind si la propriété DataSourceID est définie et que le contrôle lié aux données est marqué pour demander à être lié. (Hérité de BaseDataBoundControl.) |
|
EnsureID | Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control.) |
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
FindControl(String) | Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control.) |
|
FindControl(String, Int32) | Infrastructure. Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl. (Hérité de Control.) |
|
Focus | Affecte le focus d'entrée à un contrôle. (Hérité de Control.) |
|
GetData | Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données. |
|
GetDataSource | Récupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant. |
|
GetDesignModeState | Infrastructure. Obtient les données au moment du design pour un contrôle. (Hérité de Control.) |
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetRouteUrl(Object) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.) |
|
GetRouteUrl(RouteValueDictionary) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control.) |
|
GetRouteUrl(String, Object) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.) |
|
GetRouteUrl(String, RouteValueDictionary) | Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
GetUniqueIDRelativeTo | Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control.) |
|
HasControls | Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control.) |
|
HasEvents | Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control.) |
|
IsLiteralContent | Infrastructure. Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control.) |
|
LoadControlState | Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState. (Hérité de Control.) |
|
LoadViewState | Restaure les informations d'état d'affichage à partir d'une précédente requête enregistrées avec la méthode SaveViewState. (Hérité de WebControl.) |
|
MapPathSecure | Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control.) |
|
MarkAsDataBound | Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données. |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
MergeStyle | Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
OnBubbleEvent | Détermine si l'événement pour le contrôle serveur est passé dans la hiérarchie des contrôles serveur de l'interface utilisateur de la page. (Hérité de Control.) |
|
OnDataBinding | Déclenche l'événement DataBinding. (Hérité de Control.) |
|
OnDataBound | Déclenche l'événement DataBound. (Hérité de BaseDataBoundControl.) |
|
OnDataPropertyChanged | Relie le contrôle lié aux données à ses données après la modification d'une des propriétés de l'identification de la source de données de base. (Substitue BaseDataBoundControl.OnDataPropertyChanged().) |
|
OnDataSourceViewChanged | Déclenche l'événement DataSourceViewChanged. |
|
OnInit | Gère l'événement Init. (Hérité de BaseDataBoundControl.) |
|
OnLoad | Gère l'événement Control.Load. (Substitue Control.OnLoad(EventArgs).) |
|
OnPagePreLoad | Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. (Substitue BaseDataBoundControl.OnPagePreLoad(Object, EventArgs).) |
|
OnPreRender | Gère l'événement PreRender. (Hérité de BaseDataBoundControl.) |
|
OnUnload | Déclenche l'événement Unload. (Hérité de Control.) |
|
OpenFile | Obtient un Stream utilisé pour lire un fichier. (Hérité de Control.) |
|
PerformDataBinding | En cas de substitution dans une classe dérivée, lie des données de la source de données au contrôle. |
|
PerformSelect | Récupère les données de la source de données associée. (Substitue BaseDataBoundControl.PerformSelect().) |
|
RaiseBubbleEvent | Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control.) |
|
RemovedControl | Appelée après la suppression d'un contrôle enfant dans la collection Controls de l'objet Control. (Hérité de Control.) |
|
Render | Génère le rendu du contrôle via le writer HTML spécifié. (Hérité de WebControl.) |
|
RenderBeginTag | Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
RenderChildren | Renvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client. (Hérité de Control.) |
|
RenderContents | Génère le rendu du contenu du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
RenderControl(HtmlTextWriter) | Renvoie le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du contrôle si le traçage est activé. (Hérité de Control.) |
|
RenderControl(HtmlTextWriter, ControlAdapter) | Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control.) |
|
RenderEndTag | Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles. (Hérité de WebControl.) |
|
ResolveAdapter | Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control.) |
|
ResolveClientUrl | Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control.) |
|
ResolveUrl | Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control.) |
|
SaveControlState | Enregistre les modifications éventuellement apportées à l'état du contrôle serveur depuis la publication de la page sur le serveur. (Hérité de Control.) |
|
SaveViewState | Enregistre les états modifiés après l'appel de la méthode TrackViewState. (Hérité de WebControl.) |
|
SetDesignModeState | Définit les données au moment du design pour un contrôle. (Hérité de Control.) |
|
SetRenderMethodDelegate | Infrastructure. Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control.) |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
TrackViewState | Amène le contrôle à suivre les modifications apportées à son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState de l'objet. (Hérité de WebControl.) |
|
ValidateDataSource | Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner. (Substitue BaseDataBoundControl.ValidateDataSource(Object).) |
| Nom | Description | |
|---|---|---|
|
DataBinding | Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control.) |
|
DataBound | Se produit après la liaison du contrôle serveur à une source de données. (Hérité de BaseDataBoundControl.) |
|
Disposed | Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control.) |
|
Init | Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control.) |
|
Load | Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control.) |
|
PreRender | Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control.) |
|
Unload | Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control.) |
| Nom | Description | |
|---|---|---|
|
EnablePersistedSelection | Rend la sélection persistante dans les contrôles de données qui prennent en charge la sélection et la pagination. (Défini par DynamicDataExtensions.) |
|
FindDataSourceControl | Retourne la source de données associée au contrôle de données pour le contrôle spécifié. (Défini par DynamicDataExtensions.) |
|
FindFieldTemplate | Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. (Défini par DynamicDataExtensions.) |
|
FindMetaTable | Retourne l'objet Metatable pour le contrôle de données conteneur. (Défini par DynamicDataExtensions.) |
| Nom | Description | |
|---|---|---|
|
IAttributeAccessor.GetAttribute | Infrastructure. Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl.) |
|
IAttributeAccessor.SetAttribute | Affecte au nom et à la valeur spécifiés un attribut du contrôle Web. (Hérité de WebControl.) |
|
IControlBuilderAccessor.ControlBuilder | Pour obtenir une description de ce membre, consultez IControlBuilderAccessor.ControlBuilder. (Hérité de Control.) |
|
IControlDesignerAccessor.GetDesignModeState | Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.GetDesignModeState. (Hérité de Control.) |
|
IControlDesignerAccessor.SetDesignModeState | Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetDesignModeState. (Hérité de Control.) |
|
IControlDesignerAccessor.SetOwnerControl | Infrastructure. Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.SetOwnerControl. (Hérité de Control.) |
|
IControlDesignerAccessor.UserData | Pour obtenir une description de ce membre, consultez IControlDesignerAccessor.UserData. (Hérité de Control.) |
|
IDataBindingsAccessor.DataBindings | Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.DataBindings. (Hérité de Control.) |
|
IDataBindingsAccessor.HasDataBindings | Pour obtenir une description de ce membre, consultez IDataBindingsAccessor.HasDataBindings. (Hérité de Control.) |
|
IExpressionsAccessor.Expressions | Pour obtenir une description de ce membre, consultez IExpressionsAccessor.Expressions. (Hérité de Control.) |
|
IExpressionsAccessor.HasExpressions | Pour obtenir une description de ce membre, consultez IExpressionsAccessor.HasExpressions. (Hérité de Control.) |
|
IParserAccessor.AddParsedSubObject | Pour obtenir une description de ce membre, consultez IParserAccessor.AddParsedSubObject. (Hérité de Control.) |
La classe DataBoundControl est la classe de base utilisée pour les contrôles d'ASP.NET qui récupèrent des données sous forme de tableau ou de liste à partir d'un contrôle de source de données ASP.NET et qui lient des éléments de l'interface utilisateur du contrôle à ces données pour l'affichage. Les contrôles liés aux données composites, tels que GridView, DetailsView et FormView, les contrôles liés aux données de style liste, tels que BulletedList et CheckBoxList, et les autres contrôles, tels que AdRotator, dérivent de DataBoundControl.
Les développeurs de pages n'utilisent pas directement la classe DataBoundControl ; à la place, ils utilisent des contrôles qui dérivent de cette classe.
Les développeurs de contrôles étendent cette classe pour créer des contrôles liés aux données qui fonctionnent avec les classes qui implémentent l'interface IDataSource et les classes qui dérivent des classes DataSourceControl et DataSourceView. Lorsque vous dérivez une classe de la classe DataBoundControl, substituez la méthode PerformDataBinding pour lier les éléments d'interface utilisateur de votre contrôle aux données récupérées par la méthode GetData. Dans la plupart des cas, la méthode PerformDataBinding est la seule méthode que vous substituez dans votre classe dérivée.
Pour les contrôles liés aux données ASP.NET 2.0, la méthode PerformSelect est l'équivalent de la méthode DataBind et elle est appelée pour lier des données au moment de l'exécution. La méthode PerformSelect appelle les méthodes GetData et PerformDataBinding.
L'exemple de code suivant montre comment dériver une classe de la classe DataBoundControl pour créer un contrôle lié aux données personnalisé. Le contrôle TextBoxSet crée un contrôle TextBox pour chaque élément de données récupéré de son contrôle de source de données associé et se lie à la valeur de l'élément de données au moment de l'exécution. L'implémentation en cours de la méthode Render restitue les contrôles TextBox comme une liste non triée.
using System; using System.Collections; using System.ComponentModel; using System.Security.Permissions; using System.Web; using System.Web.UI; using System.Web.UI.WebControls; namespace Samples.AspNet.Controls.CS { [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)] [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)] public class TextBoxSet : DataBoundControl { private IList alBoxSet; public IList BoxSet { get { if (null == alBoxSet) { alBoxSet = new ArrayList(); } return alBoxSet; } } public string DataTextField { get { object o = ViewState["DataTextField"]; return((o == null) ? string.Empty : (string)o); } set { ViewState["DataTextField"] = value; if (Initialized) { OnDataPropertyChanged(); } } } protected override void PerformSelect() { // Call OnDataBinding here if bound to a data source using the // DataSource property (instead of a DataSourceID), because the // databinding statement is evaluated before the call to GetData. if (! IsBoundUsingDataSourceID) { OnDataBinding(EventArgs.Empty); } // The GetData method retrieves the DataSourceView object from // the IDataSource associated with the data-bound control. GetData().Select(CreateDataSourceSelectArguments(), OnDataSourceViewSelectCallback); // The PerformDataBinding method has completed. RequiresDataBinding = false; MarkAsDataBound(); // Raise the DataBound event. OnDataBound(EventArgs.Empty); } private void OnDataSourceViewSelectCallback(IEnumerable retrievedData) { // Call OnDataBinding only if it has not already been // called in the PerformSelect method. if (IsBoundUsingDataSourceID) { OnDataBinding(EventArgs.Empty); } // The PerformDataBinding method binds the data in the // retrievedData collection to elements of the data-bound control. PerformDataBinding(retrievedData); } protected override void PerformDataBinding(IEnumerable retrievedData) { base.PerformDataBinding(retrievedData); // If the data is retrieved from an IDataSource as an // IEnumerable collection, attempt to bind its values to a // set of TextBox controls. if (retrievedData != null) { foreach (object dataItem in retrievedData) { TextBox box = new TextBox(); // The dataItem is not just a string, but potentially // a System.Data.DataRowView or some other container. // If DataTextField is set, use it to determine which // field to render. Otherwise, use the first field. if (DataTextField.Length > 0) { box.Text = DataBinder.GetPropertyValue(dataItem, DataTextField, null); } else { PropertyDescriptorCollection props = TypeDescriptor.GetProperties(dataItem); // Set the "default" value of the TextBox. box.Text = String.Empty; // Set the true data-bound value of the TextBox, // if possible. if (props.Count >= 1) { if (null != props[0].GetValue(dataItem)) { box.Text = props[0].GetValue(dataItem).ToString(); } } } BoxSet.Add(box); } } } protected override void Render(HtmlTextWriter writer) { // Render nothing if the control is empty. if (BoxSet.Count <= 0) { return; } // Make sure the control is declared in a form tag // with runat=server. if (Page != null) { Page.VerifyRenderingInServerForm(this); } // For this example, render the BoxSet as // an unordered list of TextBox controls. writer.RenderBeginTag(HtmlTextWriterTag.Ul); foreach (object item in BoxSet) { TextBox box = (TextBox) item; // Write each element as // <li><input type="text" value="string"><input/></li> writer.WriteBeginTag("li"); writer.Write(">"); writer.WriteBeginTag("input"); writer.WriteAttribute("type", "text"); writer.WriteAttribute("value", box.Text); writer.Write(">"); writer.WriteEndTag("input"); writer.WriteEndTag("li"); } writer.RenderEndTag(); } } }
L'exemple de code suivant montre comment utiliser le contrôle TextBoxSet, défini dans l'exemple précédent, et le lier à un contrôle AccessDataSource.
<%@Page language="c#" %> <%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.Controls.CS" Assembly="Samples.AspNet.Controls.CS" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>TextBoxSet Data-Bound Control - C# Example</title> </head> <body> <form id="Form1" method="post" runat="server"> <aspSample:textboxset id="TextBoxSet1" runat="server" datasourceid="AccessDataSource1" /> <asp:accessdatasource id="AccessDataSource1" runat="server" datafile="Northwind.mdb" selectcommand="SELECT lastname FROM Employees" /> </form> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.