HtmlAnchor Classe

Definizione

Spazio dei nomi:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Consente l'accesso a livello di codice all'elemento HTML <a> nel server.

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

Ereditarietà: Object

Control

HtmlControl

HtmlContainerControl
HtmlAnchor

Implementazioni: IPostBackEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare l'evento ServerClick per visualizzare un messaggio quando si fa clic sul HtmlAnchor controllo .

<%@ 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>

Commenti

Esistono due modi per usare la HtmlAnchor classe . Il primo è per lo spostamento: utilizzando la HRef proprietà per definire la posizione della pagina a cui collegarsi. Il secondo riguarda gli eventi di postback: l'uso dell'evento ServerClick per gestire a livello di codice il clic di un collegamento da parte dell'utente.

Attenzione

Questo controllo può essere usato per visualizzare l'input dell'utente, che potrebbe includere script client dannosi. Controllare le informazioni inviate da un client per lo script eseguibile, le istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare lo script e il codice HTML nell'input dell'utente. I controlli server di convalida vengono forniti anche per valutare l'input dell'utente. Per altre informazioni, vedere Sintassi del controllo server di convalida.

Per un elenco dei valori iniziali delle proprietà per un'istanza di HtmlAnchor, vedere il costruttore HtmlAnchor.

Costruttori

Nome	Descrizione
HtmlAnchor()	Inizializza una nuova istanza della classe HtmlAnchor.

Proprietà

Nome	Descrizione
Adapter	Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control)
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control)
Attributes	Ottiene una raccolta di tutte le coppie nome e valore dell'attributo espresse in un tag di controllo server all'interno della pagina ASP.NET. (Ereditato da HtmlControl)
BindingContainer	Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control)
CausesValidation	Ottiene o imposta un valore che indica se la convalida viene eseguita quando si fa clic sul HtmlAnchor controllo .
ChildControlsCreated	Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà . (Ereditato da Control)
ClientIDSeparator	Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Disabled	Ottiene o imposta un valore che indica se il controllo server HTML è disabilitato. (Ereditato da HtmlControl)
EnableTheming	Ottiene o imposta un valore che indica se i temi si applicano a questo controllo. (Ereditato da Control)
EnableViewState	Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control)
Events	Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control)
HasChildViewState	Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
HRef	Ottiene o imposta la destinazione URL del collegamento specificato nel HtmlAnchor controllo server.
ID	Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
InnerHtml	Ottiene o imposta il contenuto trovato tra i tag di apertura e chiusura del controllo server HTML specificato. (Ereditato da HtmlContainerControl)
InnerText	Ottiene o imposta il testo tra i tag di apertura e chiusura del controllo server HTML specificato. (Ereditato da HtmlContainerControl)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control)
LoadViewStateByID	Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control)
Name	Ottiene o imposta il nome del HtmlAnchor segnalibro definito nel controllo server.
NamingContainer	Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control)
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control)
RenderingCompatibility	Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control)
Site	Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da Control)
Style	Ottiene un insieme di tutte le proprietà CSS (Cascading Style Sheet) applicate a un controllo server HTML specificato nel file ASP.NET. (Ereditato da HtmlControl)
TagName	Ottiene il nome dell'elemento di un tag che contiene un attributo e una `runat=server` coppia di valori. (Ereditato da HtmlControl)
Target	Ottiene o imposta il nome della finestra o del frame del browser che visualizza il contenuto della pagina Web a cui è collegato quando si fa clic sul HtmlAnchor controllo.
TemplateControl	Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control)
Title	Ottiene o imposta il testo della descrizione comando visualizzato quando il puntatore del mouse viene posizionato sul HtmlAnchor controllo.
UniqueID	Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control)
ValidationGroup	Ottiene o imposta il gruppo di controlli per cui il HtmlAnchor controllo causa la convalida quando esegue il postback al server.
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se lo stato di HtmlControl visualizzazione fa distinzione tra maiuscole e minuscole. (Ereditato da HtmlControl)
ViewStateMode	Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control)

Metodi

Nome	Descrizione
AddedControl(Control, Int32)	Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control)
ApplyStyleSheetSkin(Page)	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella ClientID cache su `null`. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
CreateChildControls()	Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control)
CreateControlCollection()	Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da HtmlContainerControl)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control)
DataBind(Boolean)	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control)
DataBindChildren()	Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control)
Dispose()	Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato `id` e un numero intero, specificato nel `pathOffset` parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo . (Ereditato da Control)
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato `id` . (Ereditato da Control)
Focus()	Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control)
GetAttribute(String)	Ottiene il valore dell'attributo denominato nel HtmlControl controllo . (Ereditato da HtmlControl)
GetDesignModeState()	Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control)
IsLiteralContent()	Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control)
LoadViewState(Object)	Ripristina lo HtmlContainerControl stato di visualizzazione del controllo da una richiesta di pagina precedente salvata dal SaveViewState() metodo . (Ereditato da HtmlContainerControl)
MapPathSecure(String)	Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da Control)
OnInit(EventArgs)	Genera l'evento Init. (Ereditato da Control)
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnPreRender(EventArgs)	Genera l'evento PreRender e registra lo script client per la generazione di un postback.
OnServerClick(EventArgs)	Genera l'evento ServerClick. In questo modo è possibile fornire un gestore personalizzato per l'evento.
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OpenFile(String)	Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)	Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control)
RaisePostBackEvent(String)	Genera eventi per il HtmlAnchor controllo quando esegue il postback al server.
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control)
Render(HtmlTextWriter)	Esegue il rendering del HtmlContainerControl controllo nell'oggetto specificato HtmlTextWriter . (Ereditato da HtmlContainerControl)
RenderAttributes(HtmlTextWriter)	Esegue il HtmlAnchor rendering degli attributi del controllo nell'oggetto specificato HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)	Esegue il rendering del tag HTML di apertura del controllo nell'oggetto specificato HtmlTextWriter . (Ereditato da HtmlControl)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag di chiusura per il HtmlContainerControl controllo nell'oggetto specificato HtmlTextWriter . (Ereditato da HtmlContainerControl)
ResolveAdapter()	Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control)
SaveControlState()	Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione controllo server dopo il postback della pagina al server. (Ereditato da Control)
SetAttribute(String, String)	Imposta il valore dell'attributo denominato nel HtmlControl controllo . (Ereditato da HtmlControl)
SetDesignModeState(IDictionary)	Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Determina il rilevamento delle modifiche dello stato di visualizzazione al controllo server in modo che possano essere archiviate nell'oggetto del StateBag controllo server. Questo oggetto è accessibile tramite la ViewState proprietà . (Ereditato da Control)

Eventi

Nome	Descrizione
DataBinding	Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Disposed	Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control)
Load	Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control)
ServerClick	Si verifica quando si fa clic sul HtmlAnchor controllo .
Unload	Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IAttributeAccessor.GetAttribute(String)	Per una descrizione di questo membro, vedere GetAttribute(String). (Ereditato da HtmlControl)
IAttributeAccessor.SetAttribute(String, String)	Per una descrizione di questo membro, vedere SetAttribute(String, String). (Ereditato da HtmlControl)
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Per una descrizione di questo membro, vedere RaisePostBackEvent(IPostBackEventHandler, String).

Metodi di estensione

Nome	Descrizione
FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatable per il controllo dati contenitore.

Si applica a

Vedi anche

HtmlContainerControl

Commenti e suggerimenti

Questa pagina è stata utile?