AdRotator Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Affiche une bannière de publication sur une page web.
public ref class AdRotator : System::Web::UI::WebControls::WebControlpublic ref class AdRotator : System::Web::UI::WebControls::DataBoundControlpublic class AdRotator : System.Web.UI.WebControls.WebControlpublic class AdRotator : System.Web.UI.WebControls.DataBoundControltype AdRotator = class
inherit WebControltype AdRotator = class
inherit DataBoundControlPublic Class AdRotator
Inherits WebControlPublic Class AdRotator
Inherits DataBoundControl- Héritage
- Héritage
Exemples
L’exemple de code suivant montre comment utiliser le AdRotator contrôle pour afficher une bannière publicitaire sur une page web.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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 runat="server">
<title>AdRotator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>AdRotator Example</h3>
<asp:AdRotator id="AdRotator1" runat="server"
Target="_self"
AdvertisementFile="~/App_Data/Ads.xml"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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 runat="server">
<title>AdRotator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>AdRotator Example</h3>
<asp:AdRotator id="AdRotator1" runat="server"
Target="_self"
AdvertisementFile="~/App_Data/Ads.xml"/>
</form>
</body>
</html>
L’exemple de code suivant illustre le format de fichier d’un fichier XML qui contient des informations de publicité pour l’exemple précédent. Pour plus d’informations sur le format de fichier, consultez le AdvertisementFile membre.
<Advertisements>
<Ad>
<ImageUrl>~/Images/image1.jpg</ImageUrl>
<height>60</height>
<width>190</width>
<NavigateUrl>http://www.microsoft.com</NavigateUrl>
<AlternateText>Microsoft Main Site</AlternateText>
<Impressions>80</Impressions>
<Keyword>Topic1</Keyword>
</Ad>
<Ad>
<ImageUrl>~/Images/image2.jpg</ImageUrl>
<height>90</height>
<width>90</width>
<NavigateUrl>http://www.wingtiptoys.com</NavigateUrl>
<AlternateText>Wingtip Toys</AlternateText>
<Impressions>80</Impressions>
<Keyword>Topic2</Keyword>
</Ad>
</Advertisements>
Remarques
Dans cette rubrique :
Introduction
Utilisez le AdRotator contrôle pour afficher une bannière publicitaire sélectionnée de manière aléatoire sur la page web. La publicité affichée change chaque fois que la page s’actualise.
Les informations de publicité sont stockées dans un fichier XML distinct. Le fichier XML vous permet de gérer une liste de publicités et leurs attributs associés. Les attributs incluent le chemin d’accès à une image à afficher, l’URL vers laquelle créer un lien lorsque le contrôle est cliqué, le texte de remplacement à afficher lorsque l’image n’est pas disponible, un mot clé et la fréquence de la publicité. Les informations contenues dans ce fichier ne sont pas validées par le AdRotator contrôle. Pour empêcher les publicités d’exécuter des scripts malveillants, vous devez toujours case activée les données avant de les publier, ou accepter les informations publicitaires uniquement à partir de sources approuvées.
Pour sécuriser votre fichier publicitaire contre un accès Internet non autorisé, effectuez une ou plusieurs des opérations suivantes :
- Stockez-le dans le répertoire App_Data, qui est configuré pour refuser l’accès à Internet pour les fichiers de tout type.
- Renommez le fichier avec une extension qui n’est pas .xml et mappez l’extension au dans Web.config
HttpForbiddenHandler. Pour plus d’informations, consultez lahttpHandlerssection de votre fichier Machine.config.
En guise d’alternative à un fichier XML en tant que source de données, il est possible de fournir des informations de publicité par le biais d’un événement de rappel. Cet événement peut également être utilisé en combinaison avec le fichier XML pour étendre le comportement du AdRotator contrôle, par exemple la redirection vers une autre page. Pour plus d’informations sur le format de fichier, consultez la AdvertisementFile propriété .
Notes
Lorsque la mise en cache des pages est activée, un AdRotator contrôle n’est pas mis en cache. Une nouvelle publicité est sélectionnée chaque fois que la page web est actualisée. Toutefois, une nouvelle publication n’est pas sélectionnée si vous fournissez un gestionnaire d’événements pour l’événement AdCreated .
Format de fichier de publication XML
Le AdRotator contrôle utilise un fichier de publication XML distinct pour stocker les informations publicitaires, telles que l’emplacement de l’image à afficher et l’URL de la page vers laquelle créer un lien. La AdvertisementFile propriété du AdRotator contrôle spécifie le chemin d’accès à ce fichier.
Lors de la création du fichier de publicité, les balises d’ouverture et de fermeture <Advertisements> marquent respectivement le début et la fin du fichier. Les étiquettes d’ouverture et de fermeture <Ad> délimitent chaque publicité. Toutes les publicités sont imbriquées entre les balises d’ouverture et de fermeture <Advertisements> . Si le fichier contient plusieurs <Advertisements> balises, seul le premier ensemble de <Advertisements> balises dans le fichier sera analysé par le AdRotator contrôle. Toutes les autres <Advertisements> étiquettes seront ignorées.
Les éléments de données de chaque publication sont imbriqués entre les balises d’ouverture et de fermeture <Ad> . Bien que certains éléments de données soient prédéfinis (tels que ImageUrl et NavigateUrl), vous pouvez placer des éléments personnalisés entre les <Ad> balises. Ces éléments sont lus par le contrôle lors de l’analyse AdRotator du fichier. Les informations sont ensuite transmises à l’événement AdCreated dans la AdProperties propriété du dictionnaire.
Le tableau suivant répertorie les éléments de données prédéfinis pour le fichier de publication XML.
| Élément | Description |
|---|---|
ImageUrl |
URL absolue ou relative d’un fichier image (facultatif). |
NavigateUrl |
URL d’une page vers laquelle créer un lien si l’utilisateur clique sur l’annonce (facultatif). Note: Si cet élément n’est pas défini, la HRef propriété n’est pas affichée sur la balise d’ancre. |
Height |
Hauteur de l’image, en pixels (facultatif). |
Width |
Largeur de l’image, en pixels (facultatif). |
AlternateText |
Texte affiché à la place de l’image lorsque l’image spécifiée par la ImageUrl propriété n’est pas disponible (facultatif). Dans certains navigateurs, ce texte apparaît également en tant que ToolTip pour la publicité. |
Keyword |
Catégorie de la publicité (par exemple, « ordinateurs ») que vous pouvez filtrer (facultatif). |
Impressions |
Nombre qui indique l’importance de l’annonce dans la planification de rotation par rapport aux autres annonces du fichier (facultatif). Plus le nombre est élevé, plus la publicité est souvent affichée. Le total de toutes les <Impressions> valeurs du fichier XML ne peut pas dépasser 2 047 999 999. Si c’est le cas, le AdRotator contrôle lève une exception d’exécution. |
L’exemple suivant montre le format du fichier de publicité XML.
<Advertisements>
<Ad>
<ImageUrl>
URL of image to display for Advertisement #1
</ImageUrl>
<NavigateUrl>
URL of page to link to for Advertisement #1
</NavigateUrl>
<AlternateText>
Text to show as a ToolTip for Advertisement #1
</AlternateText>
<Keyword>
Keyword used to filter for Advertisement #1
</Keyword>
<Impressions>
Relative importance of Advertisement #1
</Impressions>
<CustomInformation>
Custom Data about Advertisement #1
</CustomInformation>
</Ad>
</Advertisements>
Syntaxe déclarative
<asp:AdRotator
AccessKey="string"
AdvertisementFile="uri"
AlternateTextField="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ImageUrlField="string"
KeywordFilter="string"
NavigateUrlField="string"
OnAdCreated="AdCreated event handler"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Target="string|_blank|_parent|_search|_self|_top"
ToolTip="string"
Visible="True|False"
Width="size"
/>
Constructeurs
| AdRotator() |
Initialise une nouvelle instance de la classe AdRotator. |
Propriétés
| 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) |
| AdvertisementFile |
Obtient ou définit le chemin d'accès à un fichier XML qui contient les informations relatives à une publication. |
| AlternateTextField |
Obtient ou définit un champ de données personnalisé à utiliser à la place de l'attribut |
| 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 |
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 du 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 pour 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. (Hérité de DataBoundControl) |
| 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 à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données. (Hérité de DataBoundControl) |
| DataSourceObject |
Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet. (Hérité de DataBoundControl) |
| 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 conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (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 de bannière de publication. |
| 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 |
Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control) |
| ImageUrlField |
Obtient ou définit un champ de données personnalisé à utiliser à la place de l'attribut |
| 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) |
| IsDataBindingAutomatic |
Obtient une valeur qui indique si la liaison de données est automatique. (Hérité de BaseDataBoundControl) |
| 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) |
| IsUsingModelBinders |
Obtient une valeur qui indique si la liaison de modèle est utilisée. (Hérité de DataBoundControl) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control) |
| ItemType |
Obtient ou définit le nom du type d'élément de données pour la liaison de données fortement typée. (Hérité de DataBoundControl) |
| KeywordFilter |
Obtient ou définit un mot clé de catégorie pour filtrer des types spécifiques de publications dans le fichier de publications XML. |
| 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é ID possède la même valeur. (Hérité de Control) |
| NavigateUrlField |
Obtient ou définit un champ de données personnalisé à utiliser à la place de l'attribut |
| 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 d'un contrôle de source de données. (Hérité de DataBoundControl) |
| SelectMethod |
Nom de la méthode à appeler pour pouvoir lire les données. (Hérité de DataBoundControl) |
| 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 définir l'attribut |
| SupportsDisabledAttribute |
Obtient une valeur qui indique si le contrôle doit définir l'attribut |
| TabIndex |
Obtient ou définit l'index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
| TagKey |
Obtient la balise HTML du contrôle AdRotator. |
| TagKey |
Obtient la valeur HtmlTextWriterTag qui correspond à ce 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) |
| Target |
Obtient ou définit le nom de la fenêtre du navigateur ou du frame qui affiche le contenu de la page Web atteinte lorsqu'un clic a été effectué sur le contrôle AdRotator. |
| 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 AdRotator. |
| UniqueID |
Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control) |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (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 en tant qu’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) |
Méthodes
| AddAttributesToRender(HtmlTextWriter) |
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(Control, Int32) |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control) |
| ApplyStyle(Style) |
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(Page) |
Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le traçage au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
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() |
Affecte à la valeur ClientID mise en cache la valeur |
| 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() |
Affecte la valeur ClientIDMode à la propriété Inherit 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(WebControl) |
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ée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu. (Hérité de Control) |
| CreateControlCollection() |
Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. |
| CreateControlCollection() |
Crée un 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é. (Hérité de DataBoundControl) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control) |
| 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) |
| EndRenderTracing(TextWriter, Object) |
Met fin au traçage au moment du design des données de rendu. (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'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| FindControl(String) |
Recherche un contrôle serveur possédant le paramètre |
| FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
| 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. (Hérité de DataBoundControl) |
| GetDataSource() |
Récupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant. (Hérité de DataBoundControl) |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (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(Control) |
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() |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
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(Object) |
Restaure les informations d'état d'affichage d'une demande précédente enregistrée avec la méthode SaveViewState(). (Hérité de WebControl) |
| LoadViewState(Object) |
Restaure les informations d’état d’affichage d’une précédente requête de page enregistrées par la méthode SaveViewState(). (Hérité de DataBoundControl) |
| MapPathSecure(String) |
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. (Hérité de DataBoundControl) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| MergeStyle(Style) |
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) |
| OnAdCreated(AdCreatedEventArgs) | |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page. (Hérité de Control) |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Déclenche l’événement CreatingModelDataSource. (Hérité de DataBoundControl) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnDataBound(EventArgs) |
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. (Hérité de DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Déclenche l’événement DataSourceViewChanged. (Hérité de DataBoundControl) |
| OnInit(EventArgs) |
Déclenche l’événement Init. |
| OnInit(EventArgs) |
Déclenche l’événement Init. (Hérité de Control) |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnLoad(EventArgs) |
Gère l'événement Load. (Hérité de DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé. (Hérité de DataBoundControl) |
| OnPreRender(EventArgs) |
Reçoit les informations de publication à afficher en recherchant les données de fichier ou en appelant l'événement d'utilisateur. |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream utilisé pour lire un fichier. (Hérité de Control) |
| PerformDataBinding(IEnumerable) |
Lie la source de données spécifiée au contrôle AdRotator. |
| PerformSelect() |
Récupère les données de publication de la source de données associée. |
| RaiseBubbleEvent(Object, EventArgs) |
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control) |
| RemovedControl(Control) |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
| Render(HtmlTextWriter) |
Affiche le contrôle AdRotator sur le client. |
| RenderBeginTag(HtmlTextWriter) |
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(HtmlTextWriter) |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
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) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le 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(HtmlTextWriter) |
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(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control) |
| SaveControlState() |
Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre les états qui ont été modifiés après l’appel de la méthode TrackViewState(). (Hérité de WebControl) |
| SaveViewState() |
Enregistre les modifications éventuellement apportées à l'état d'affichage depuis la publication de la page sur le serveur. (Hérité de DataBoundControl) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetRenderMethodDelegate(RenderMethod) |
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) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| TrackViewState() |
Force le contrôle à suivre les modifications apportées à son état d’affichage afin qu’elles puissent être stockées dans la propriété ViewState. (Hérité de WebControl) |
| TrackViewState() |
Provoque le suivi des modifications de l'état d'affichage pour le contrôle afin qu'elles puissent être stockées dans l'objet StateBag du contrôle. (Hérité de DataBoundControl) |
| ValidateDataSource(Object) |
Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner. (Hérité de DataBoundControl) |
Événements
| AdCreated |
Se produit une fois par aller-retour vers le serveur après la création du contrôle et avant que la page soit rendue. |
| CallingDataMethods |
Se produit lorsque les méthodes de données sont appelées. (Hérité de DataBoundControl) |
| CreatingModelDataSource |
Se produit lorsque l'objet ModelDataSource est créé. (Hérité de DataBoundControl) |
| 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) |
Implémentations d’interfaces explicites
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
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 ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
Méthodes d’extension
| EnablePersistedSelection(BaseDataBoundControl) |
Obsolète.
Permet la conservation de la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination. |
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
S’applique à
Voir aussi
Commentaires
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez : https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour