Partager via

HtmlAnchor Classe

Définition

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

Autorise l’accès par programmation à l’élément HTML <a> 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 le HtmlAnchor contrôle est cliqué.

<%@ 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 est destinée à la navigation : à l’aide de la HRef propriété pour définir l’emplacement de la page à lier. 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.

Avertissement

Ce contrôle peut être utilisé pour afficher l’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 l’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. Les contrôles de serveur de validation sont également fournis pour évaluer l’entrée utilisateur. Pour plus d’informations, consultez La syntaxe de contrôle du serveur de validation.

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

Constructeurs

Nom Description
HtmlAnchor()

Initialise une nouvelle instance de la classe HtmlAnchor.

Propriétés

Nom Description
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 du ou UserControl de l’objet Page qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient une collection de toutes les paires nom et valeur d’attribut exprimées sur une balise de contrôle serveur dans 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 la validation est effectuée lorsque le HtmlAnchor contrôle est cliqué.
ChildControlsCreated

Obtient une valeur qui indique si les 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 ClientID propriété.

(Hérité de Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété.

(Hérité de Control)
Context

Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle.

(Hérité de Control)
Controls

Obtient un ControlCollection objet 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)
DataItemContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente .

(Hérité de Control)
DataKeysContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente .

(Hérité de Control)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une surface 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 des contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient une liste de délégués de gestionnaire 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 actuel ont des paramètres d’état d’affichage enregistrés.

(Hérité de Control)
HRef

Obtient ou définit la cible d’URL du lien spécifié dans le HtmlAnchor contrôle serveur.
ID

Obtient ou définit l’identificateur programmatique affecté au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer les identificateurs de contrôle.

(Hérité de Control)
InnerHtml

Obtient ou définit le contenu trouvé 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 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 ont un état de 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 ID au lieu de l’index.

(Hérité de Control)
Name

Obtient ou définit le nom du signet défini dans le HtmlAnchor contrôle serveur.
NamingContainer

Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété.

(Hérité de Control)
Page

Obtient une référence à l’instance 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 page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible.

(Hérité de Control)
Site

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception.

(Hérité de Control)
SkinID

Obtient ou définit la peau à 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) 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 runat=server paire d’attributs et de valeurs.

(Hérité de HtmlControl)
Target

Obtient ou définit le nom de la fenêtre ou du cadre du navigateur qui affiche le contenu de la page Web liée lorsque le HtmlAnchor contrôle est cliqué.
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 PageUserControl ou qui contient le contrôle serveur actuel.

(Hérité de Control)
Title

Obtient ou définit le texte info-bulle affiché lorsque le pointeur de la souris est placé sur le HtmlAnchor contrôle.
UniqueID

Obtient l’identificateur unique qualifié hiérarchiquement pour le 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 du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses.

(Hérité de Control)
ValidationGroup

Obtient ou définit le groupe de contrôles pour lesquels le HtmlAnchor contrôle provoque la validation lorsqu’il revient au 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 sur plusieurs requêtes pour la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l’état d’affichage respecte la HtmlControl 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

Nom Description
AddedControl(Control, Int32)

Appelé après l’ajout d’un contrôle enfant à la Controls collection 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 du ControlCollection contrôle serveur.

(Hérité de Control)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le suivi 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 le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Définit la valeur mise en ClientID cache sur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations d’état d’affichage et d’état de contrôle pour 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()

Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit.

(Hérité de Control)
CreateChildControls()

Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu.

(Hérité de Control)
CreateControlCollection()

Crée un ControlCollection objet pour contenir les contrôles enfants (littéral 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 de serveur d’effectuer le nettoyage final avant de libérer de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au suivi 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. Si ce n’est pas le cas, il crée des contrôles enfants.

(Hérité de Control)
EnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.

(Hérité de Control)
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
FindControl(String, Int32)

Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié id et spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode.

(Hérité de Control)
FindControl(String)

Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié id .

(Hérité de Control)
Focus()

Définit le focus d’entrée sur un contrôle.

(Hérité de Control)
GetAttribute(String)

Obtient la valeur de l’attribut nommé sur le HtmlControl contrôle.

(Hérité de HtmlControl)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l’URL qui correspond à un ensemble 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 ensemble de paramètres d’itinéraire et à un nom d’itinéraire.

(Hérité de Control)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété 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 les événements sont inscrits pour le contrôle ou les contrôles enfants.

(Hérité de Control)
IsLiteralContent()

Détermine si le contrôle serveur contient uniquement du contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode.

(Hérité de Control)
LoadViewState(Object)

Restaure l’état HtmlContainerControl d’affichage du contrôle à partir d’une demande de page précédente enregistrée par la SaveViewState() méthode.

(Hérité de HtmlContainerControl)
MapPathSecure(String)

Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
OnBubbleEvent(Object, EventArgs)

Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’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 et inscrit le PreRender script client pour générer une publication différée.
OnServerClick(EventArgs)

Déclenche l’événement ServerClick. Cela vous permet de fournir un gestionnaire personnalisé pour l’événement.
OnUnload(EventArgs)

Déclenche l’événement Unload.

(Hérité de Control)
OpenFile(String)

Obtient un Stream élément utilisé pour lire un fichier.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Affecte toutes les sources 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 HtmlAnchor contrôle lorsqu’il publie sur le serveur.
RemovedControl(Control)

Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control .

(Hérité de Control)
Render(HtmlTextWriter)

Restitue le HtmlContainerControl contrôle à l’objet spécifié HtmlTextWriter .

(Hérité de HtmlContainerControl)
RenderAttributes(HtmlTextWriter)

Restitue les HtmlAnchor attributs du contrôle à l’objet spécifié HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)

Affiche la balise HTML ouvrante du contrôle dans l’objet spécifié HtmlTextWriter .

(Hérité de HtmlControl)
RenderChildren(HtmlTextWriter)

Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter .

(Hérité de Control)
RenderControl(HtmlTextWriter)

Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé.

(Hérité de Control)
RenderEndTag(HtmlTextWriter)

Affiche la balise de fermeture du HtmlContainerControl contrôle sur l’objet spécifié HtmlTextWriter .

(Hérité de HtmlContainerControl)
ResolveAdapter()

Obtient l’adaptateur de contrôle 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 utilisable sur le client demandeur.

(Hérité de Control)
SaveControlState()

Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur.

(Hérité de Control)
SaveViewState()

Enregistre les modifications de l’état d’affichage du contrôle de serveur qui se sont produites depuis la publication de la page sur le serveur.

(Hérité de Control)
SetAttribute(String, String)

Définit la valeur de l’attribut nommé sur le HtmlControl contrôle.

(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)

Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de 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 d’état d’affichage apportées au contrôle serveur afin qu’ils puissent être stockés dans l’objet du StateBag contrôle serveur. Cet objet est accessible via la ViewState propriété.

(Hérité de Control)

Événements

Nom Description
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, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, qui est 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 lorsque le HtmlAnchor contrôle est cliqué.
Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)

Implémentations d’interfaces explicites

Nom Description
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

Nom Description
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 de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)

Retourne l’objet métatable pour le contrôle de données contenant.

S’applique à

Voir aussi