LinkButton-Klasse
Zeigt ein Schaltflächensteuerelement im Hyperlinkformat auf einer Webseite an.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class LinkButton
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler
'Usage
Dim instance As LinkButton
public class LinkButton : WebControl, IButtonControl, IPostBackEventHandler
public ref class LinkButton : public WebControl, IButtonControl, IPostBackEventHandler
public class LinkButton extends WebControl implements IButtonControl, IPostBackEventHandler
public class LinkButton extends WebControl implements IButtonControl, IPostBackEventHandler
Hinweise
Mithilfe des LinkButton-Steuerelements wird ein Schaltflächensteuerelement in Form eines Hyperlinks auf der Webseite erstellt. Die Darstellung des LinkButton-Steuerelements entspricht der des HyperLink-Steuerelements, aber es besitzt dieselben Funktionen wie ein Button-Steuerelement. Wenn durch Klicken auf das Steuerelement eine Verknüpfung mit einer anderen Webseite hergestellt werden soll, kann das HyperLink-Steuerelement verwendet werden.
Hinweis
Das LinkButton-Steuerelement gibt an den Clientbrowser JavaScript zurück. Im Clientbrowser muss JavaScript aktiviert sein, damit dieses Steuerelement ordnungsgemäß funktioniert. Weitere Informationen über Clientskripts finden Sie unter Clientskript in ASP.NET-Webseiten.
Sie können entweder eine Senden-Schaltfläche oder eine Befehlsschaltfläche erstellen. Einer Senden-Schaltfläche ist kein Befehlsname zugeordnet. Mithilfe dieser Schaltfläche wird nur die Webseite zurück an den Server gesendet. Ein LinkButton-Steuerelement ist standardmäßig eine Senden-Schaltfläche. Sie können einen Ereignishandler für das Click-Ereignis bereitstellen, um die beim Klicken auf die Senden-Schaltfläche ausgeführten Aktionen programmgesteuert zu steuern. Eine Befehlschaltfläche verfügt hingegen über einen zugeordneten Befehlsnamen, z. B. Sort. Legen Sie zum Angeben des Befehlsnamens die CommandName-Eigenschaft fest. So können Sie auf einer Webseite mehrere LinkButton-Steuerelemente erstellen und programmgesteuert ermitteln, auf welches LinkButton-Steuerelement geklickt wurde. Die CommandArgument-Eigenschaft kann auch mit einer Befehlsschaltfläche verwendet werden, um zusätzliche Informationen über den auszuführenden Befehl bereitzustellen, z. B. das Angeben einer aufsteigenden Sortierung. Sie können auch einen Ereignishandler für das Command-Ereignis bereitstellen, um die beim Klicken auf die Befehlsschaltfläche ausgeführte Aktion programmgesteuert zu steuern.
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 Eingabeaufforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Validierungs-Serversteuerelemente werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.
Standardmäßig wird beim Klicken auf ein LinkButton-Steuerelement eine Seitenvalidierung durchgeführt. Die Seitenvalidierung ermittelt, ob die einem Validierungssteuerelement auf der Seite zugeordneten Eingabesteuerelemente allen Validierungsregeln entsprechen, die durch das Validierungssteuerelement festgelegt sind. Wenn keine Seitenvalidierung durchgeführt werden soll, muss die CausesValidation-Eigenschaft auf false festgelegt werden.
Eingabehilfen
Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.
Beispiel
Das folgende Beispiel veranschaulicht, wie ein LinkButton-Steuerelement erstellt wird, das beim Klicken auf den Link Text in einem Label-Steuerelement anzeigt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script language="VB" runat="server">
Sub LinkButton_Click(sender As Object, e As EventArgs)
Label1.Text = "You clicked the link button"
End Sub
</script>
</head>
<body>
<form runat=server>
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Name="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<p>
<asp:Label id=Label1 runat=server />
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script language="C#" runat="server">
void LinkButton_Click(Object sender, EventArgs e)
{
Label1.Text="You clicked the link button";
}
</script>
</head>
<body>
<form runat=server>
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Name="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<p>
<asp:Label id=Label1 runat=server />
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script language="JSCRIPT" runat="server">
function LinkButton_Click(sender : Object, e : EventArgs){
Label1.Text = "You clicked the link button"
}
</script>
</head>
<body>
<form runat=server>
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Name="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<p>
<asp:Label id=Label1 runat=server />
</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.WebControls.WebControl
System.Web.UI.WebControls.LinkButton
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
LinkButton-Member
System.Web.UI.WebControls-Namespace
Button-Klasse
ImageButton-Klasse
HyperLink-Klasse
Weitere Ressourcen
Button-Webserver-Steuerelemente
Clientskript in ASP.NET-Webseiten