HtmlAnchor Classe

Référence

Définition

Espace de noms:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

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.

Autorise l’accès programmatique à l’élément <a> HTML sur le serveur.

public ref class HtmlAnchor : System::Web::UI::HtmlControls::HtmlContainerControl, System::Web::UI::IPostBackEventHandler

public class HtmlAnchor : System.Web.UI.HtmlControls.HtmlContainerControl, System.Web.UI.IPostBackEventHandler

type HtmlAnchor = class
    inherit HtmlContainerControl
    interface IPostBackEventHandler

Public Class HtmlAnchor
Inherits HtmlContainerControl
Implements IPostBackEventHandler

Héritage: Object

Control

HtmlControl

HtmlContainerControl
HtmlAnchor

Implémente: IPostBackEventHandler

Exemples

L’exemple de code suivant montre comment utiliser l’événement ServerClick pour afficher un message lorsque l’utilisateur clique sur le HtmlAnchor contrôle.

<%@ 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" >
   <script runat="server" >
  
      void AnchorBtn_Click(Object sender, EventArgs e)
      {
         // Display a message when the HtmlAnchor control is clicked.
         Message.InnerHtml = "Hello World!";
      }
  
   </script>
  
<head runat="server">
    <title> HtmlAnchor Control Example </title>
</head>
<body>

   <form id="form1" runat="server">
  
      <h3> HtmlAnchor Control Example </h3> 
  
      <a id="AnchorButton"
         onserverclick="AnchorBtn_Click"
         title="Hello World!" 
         runat="server">
 
         Click here

      </a>
   
      <h1>
         <span id="Message" runat="server"/>
      </h1>
  
   </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" >
   <script runat="server">
  
      Sub AnchorBtn_Click(sender As Object, e As EventArgs)

         ' Display a message when the HtmlAnchor control is clicked.
         Message.InnerHtml = "Hello World!"
      
      End Sub
  
   </script>
  
<head runat="server">
    <title> HtmlAnchor Control Example </title>
</head>
<body>

   <form id="form1" runat="server">
  
      <h3> HtmlAnchor Control Example </h3> 
  
      <a id="AnchorButton"
         onserverclick="AnchorBtn_Click" 
         title="Hello World!"
         runat="server">
 
         Click here

      </a>
   
      <h1>
         <span id="Message" runat="server"/>
      </h1>
  
   </form>

</body>
</html>

Remarques

Il existe deux façons d’utiliser la HtmlAnchor classe . La première concerne la navigation : utilisation de la HRef propriété pour définir l’emplacement de la page vers laquelle établir un lien. La seconde concerne les événements de publication : l’utilisation de l’événement ServerClick pour gérer par programmation le clic de l’utilisateur sur un lien.

Attention

Ce contrôle peut être utilisé pour afficher une entrée utilisateur, qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou tout autre code avant de les afficher dans votre application. ASP.NET fournit une fonctionnalité de validation de demande d’entrée pour bloquer le script et le code HTML dans l’entrée utilisateur. Des contrôles serveur de validation sont également fournis pour évaluer les entrées utilisateur. Pour plus d’informations, consultez Syntaxe du contrôle de serveur de validation.

Pour obtenir la liste des valeurs de propriété initiales pour une instance de HtmlAnchor, consultez le HtmlAnchor constructeur .

Constructeurs

HtmlAnchor()

Initialise une nouvelle instance de la classe HtmlAnchor.

Propriétés

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 une collection de toutes les paires nom/valeur d'attribut exprimées dans une balise de contrôle serveur au sein de la page ASP.NET. (Hérité de HtmlControl)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
CausesValidation	Obtient ou définit une valeur indiquant si une validation est effectuée suite à un clic sur le contrôle HtmlAnchor.
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)
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)
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control)
Disabled	Obtient ou définit une valeur indiquant si le contrôle serveur HTML est désactivé. (Hérité de HtmlControl)
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de Control)
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)
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)
HRef	Obtient ou définit la cible URL du lien spécifié dans le contrôle serveur HtmlAnchor.
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)
InnerHtml	Obtient ou définit le contenu compris entre les balises d'ouverture et de fermeture du contrôle serveur HTML spécifié. (Hérité de HtmlContainerControl)
InnerText	Obtient ou définit le texte compris entre les balises d'ouverture et de fermeture du contrôle serveur HTML spécifié. (Hérité de HtmlContainerControl)
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control)
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)
Name	Obtient ou définit le nom du signet défini dans le contrôle serveur HtmlAnchor.
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)
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)
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 Control)
Style	Obtient une collection de toutes les propriétés de feuille de style en cascade (CSS) qui sont appliquées à un contrôle serveur HTML spécifié dans le fichier ASP.NET. (Hérité de HtmlControl)
TagName	Obtient le nom d'élément d'une balise qui contient une paire attribut/valeur `runat=server`. (Hérité de HtmlControl)
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 lors d'un clic sur le contrôle HtmlAnchor.
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)
Title	Obtient ou définit le texte de l'info-bulle qui s'affiche lorsque le pointeur de la souris est placé sur le contrôle HtmlAnchor.
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)
ValidationGroup	Obtient ou définit le groupe de contrôles pour lequel le contrôle HtmlAnchor provoque la validation lors de la publication sur le serveur.
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'état d'affichage HtmlControl respecte la casse. (Hérité de HtmlControl)
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)

Méthodes

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)
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 `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()	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)
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. (Hérité de HtmlContainerControl)
DataBind()	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control)
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)
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 `id` spécifié dans le conteneur d'attribution de noms actuel. (Hérité de Control)
FindControl(String, Int32)	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)
GetAttribute(String)	Obtient la valeur de l'attribut nommé du contrôle HtmlControl. (Hérité de HtmlControl)
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 l'état d'affichage du contrôle HtmlContainerControl à partir d'une demande de page antérieure enregistrée par la méthode SaveViewState(). (Hérité de HtmlContainerControl)
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)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
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)
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnInit(EventArgs)	Déclenche l’événement Init. (Hérité de Control)
OnLoad(EventArgs)	Déclenche l’événement Load. (Hérité de Control)
OnPreRender(EventArgs)	Déclenche l'événement PreRender et enregistre le script client pour générer une publication (postback).
OnServerClick(EventArgs)	Déclenche l’événement ServerClick. Cela vous permet de fournir un gestionnaire personnalisé à l'événement.
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)
RaiseBubbleEvent(Object, EventArgs)	Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control)
RaisePostBackEvent(String)	Déclenche des événements pour le contrôle HtmlAnchor pendant la publication sur le serveur.
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)	Génère le rendu du contrôle HtmlContainerControl via l'objet HtmlTextWriter spécifié. (Hérité de HtmlContainerControl)
RenderAttributes(HtmlTextWriter)	Affiche les attributs du contrôle HtmlAnchor sur l’objet HtmlTextWriter spécifié.
RenderBeginTag(HtmlTextWriter)	Génère le rendu de la balise HTML d'ouverture du contrôle dans l'objet HtmlTextWriter spécifié. (Hérité de HtmlControl)
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)
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)	Restitue la balise de fermeture du contrôle HtmlContainerControl via l'objet HtmlTextWriter spécifié. (Hérité de HtmlContainerControl)
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 changements d’état d’affichage du contrôle serveur qui se sont produits depuis que la page a été republiée sur le serveur. (Hérité de Control)
SetAttribute(String, String)	Obtient la valeur de l'attribut nommé sur le contrôle HtmlControl. (Hérité de HtmlControl)
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()	Provoque le suivi des modifications de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. Cet objet est accessible via la propriété ViewState. (Hérité de Control)

Événements

DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
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)
ServerClick	Se produit suite à un clic sur le contrôle HtmlAnchor.
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)	Pour obtenir une description de ce membre, consultez GetAttribute(String). (Hérité de HtmlControl)
IAttributeAccessor.SetAttribute(String, String)	Pour obtenir une description de ce membre, consultez SetAttribute(String, String). (Hérité de HtmlControl)
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)
IPostBackEventHandler.RaisePostBackEvent(String)	Pour obtenir une description de ce membre, consultez RaisePostBackEvent(IPostBackEventHandler, String).

Méthodes d’extension

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

HtmlContainerControl

Partager via