HtmlAnchor-Klasse

Artikel
08/20/2007

Ermöglicht den programmgesteuerten Zugriff auf das HTML-<a>-Element auf dem Server.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Class HtmlAnchor
    Inherits HtmlContainerControl
    Implements IPostBackEventHandler
'Usage
Dim instance As HtmlAnchor

public class HtmlAnchor : HtmlContainerControl, IPostBackEventHandler

public ref class HtmlAnchor : public HtmlContainerControl, IPostBackEventHandler

public class HtmlAnchor extends HtmlContainerControl implements IPostBackEventHandler

public class HtmlAnchor extends HtmlContainerControl implements IPostBackEventHandler

Hinweise

Es gibt zwei Möglichkeiten, die HtmlAnchor-Klasse zu verwenden. Die erste wird zur Navigation verwendet: Verwenden der HRef-Eigenschaft zum Definieren der Position der Seite, mit der eine Verknüpfung hergestellt werden soll. Die zweite wird für Postback-Ereignisse verwendet: Verwenden des ServerClick-Ereignisses zur programmgesteuerten Behandlung von Mausklicks des Benutzers auf einen Hyperlink.

Warnung

Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die u. U. böswillige Clientskripts enthalten können. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder anderen Code, bevor Sie sie in der Anwendung anzeigen. ASP.NET stellt ein Validierungsfeature für Eingabeanforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Validierungsserversteuerelemente werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlAnchor finden Sie unter HtmlAnchor-Konstruktor.

Thema	Position
Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax	Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen	Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe des ServerClick-Ereignisses eine Meldung angezeigt wird, wenn auf das HtmlAnchor-Steuerelement geklickt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
   <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>
  
<body>

   <form runat="server">
  
      <h3> HtmlAnchor Control Example </h3> 
  
      <a ID="AnchorButton"
         OnServerClick="AnchorBtn_Click" 
         runat="server">
 
         Click here

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

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
   <script runat="server" >
  
      void AnchorBtn_Click(Object sender, EventArgs e)
      {
         // Display a message when the HtmlAnchor control is clicked.
         Message.InnerHtml = "Hello World!";
      }
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> HtmlAnchor Control Example </h3> 
  
      <a ID="AnchorButton"
         OnServerClick="AnchorBtn_Click" 
         runat="server">
 
         Click here

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

</body>
</html>

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
   <script runat="server" >

      function AnchorBtn_Click(sender : Object, e : EventArgs)
      {
         // Display a message when the HtmlAnchor control is clicked.
         Message.InnerHtml = "Hello World!";
      }
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> HtmlAnchor Control Example </h3> 
  
      <a ID="AnchorButton"
         OnServerClick="AnchorBtn_Click" 
         runat="server">
 
         Click here

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

</body>
</html>

.NET Framework-Sicherheit

AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.HtmlControls.HtmlControl
       System.Web.UI.HtmlControls.HtmlContainerControl
        System.Web.UI.HtmlControls.HtmlAnchor

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlAnchor-Member
System.Web.UI.HtmlControls-Namespace
HtmlContainerControl

Weitere Ressourcen

Deklarative Syntax des HtmlAnchor-Serversteuerelements
HTML-Serversteuerelemente

Freigeben über