Deklarative Syntax des HyperLink-Webserversteuerelements
Aktualisiert: November 2007
Erstellt auf der Seite einen Link, auf den die Benutzer klicken können, um zu einer anderen Seite zu wechseln.
<asp:HyperLink
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ImageUrl="uri"
href="uri"
OnDataBinding="DataBinding 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"
Text="string"
ToolTip="string"
Visible="True|False"
Width="size"
/>
Hinweise
Mithilfe des HyperLink-Steuerelements können Sie einen Link erstellen, mit dem Sie auf eine andere Seite oder an eine andere Stelle auf der aktuellen Seite wechseln können. Geben Sie mithilfe der href-Eigenschaft die Seite oder Position an, auf die Sie verweisen möchten. Der Link kann entweder als Text oder als Bild dargestellt werden. Um Text anzuzeigen, legen Sie entweder die Text-Eigenschaft fest, oder fügen Sie den Text zwischen dem Starttag und dem Endtag des HyperLink-Steuerelements ein. Um ein Bild anzuzeigen, legen Sie die ImageUrl-Eigenschaft fest.
Tipp
Da das <asp:HyperLink>-Element auch leer bleiben kann, können Sie das Tag anstatt mit einem separaten Endtag mit /> schließen.
Wenn sowohl die Text-Eigenschaft als auch die ImageUrl-Eigenschaft festlegt sind, hat die ImageUrl-Eigenschaft Vorrang. Falls das Bild nicht verfügbar ist, wird der Text der Text-Eigenschaft angezeigt. Bei Browsern, die das QuickInfo-Feature unterstützen, wird der Wert der Text-Eigenschaft angezeigt, wenn der Benutzer den Mauszeiger über dem HyperLink-Steuerelement positioniert.
Sie können den Frame oder das Fenster angeben, in dem die verknüpfte Seite angezeigt werden soll, indem Sie die Target-Eigenschaft festlegen. Werte müssen mit einem Buchstaben aus dem Bereich von A bis Z (ohne Berücksichtigung der Groß- und Kleinschreibung) beginnen, mit Ausnahme der folgenden speziellen Werte, die mit einem Unterstrich beginnen:
_blank |
Zeigt die verknüpfte Seite in einem neuen Fenster ohne Frames an. |
_parent |
Zeigt die verknüpfte Seite im unmittelbar übergeordneten Frameset an. |
_self |
Zeigt die verknüpfte Seite in dem Frame an, der den Fokus hat. |
_top |
Zeigt die verknüpfte Seite im gesamten Fenster ohne Frames an. |
Warnung
Text wird erst dann HTML-codiert, wenn er im HyperLink-Steuerelement angezeigt wird. Auf diese Weise können Skripts in HTML-Tags in den Text eingebunden werden. Wenn die Werte in diesem Steuerelement aus Benutzereingaben stammen, müssen die Werte unbedingt validiert werden, um die Sicherheit zu gewährleisten.
Ausführliche Informationen zu den Eigenschaften und Ereignissen des HyperLink-Webserversteuerelements finden Sie in der Dokumentation zu HyperLink.
Wenn Sie das HyperLink-Webserversteuerelement verwenden, um zwischen den Seiten einer Anwendung zu navigieren, können Sie mit dem Tildeplatzhalterzeichen ("~") den Anwendungsstamm angeben, ohne einen Verzeichnisnamen für den URL relativ zur Anwendung hartkodieren zu müssen. Mit "~/Default.aspx" könnten Sie z. B. von jeder beliebigen Seite in einem beliebigen Unterverzeichnis der Anwendung zurück zur Seite Default.aspx der Anwendung navigieren.
Beispiel
Das folgende Beispiel veranschaulicht, wie Sie mit einem HyperLink-Steuerelement zu einer anderen Webseite wechseln können.
<%@ 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>
<title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Example</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
href="https://www.microsoft.com"
Text="Microsoft Official Site"
Target="_new"
runat="server"/>
</form>
</body>
</html>
<%@ 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>
<title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Example</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
href="https://www.microsoft.com"
Text="Microsoft Official Site"
Target="_new"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" 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>
<title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Example</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
href="https://www.microsoft.com"
Text="Microsoft Official Site"
Target="_new"
runat="server"/>
</form>
</body>
</html>