Deklarative Syntax des LinkButton-Webserversteuerelements
Aktualisiert: November 2007
Erstellt eine Schaltfläche als Hyperlink auf einer Web Forms-Seite.
<asp:LinkButton
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CommandArgument="string"
CommandName="string"
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"
OnClick="Click event handler"
OnClientClick="string"
OnCommand="Command event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PostBackUrl="uri"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Hinweise
Mit dem LinkButton-Steuerelements können Sie eine Schaltfläche in Form eines Hyperlinks auf einer Web Forms-Seite erstellen. Sie können den im LinkButton-Steuerelement anzuzeigenden Text angeben, indem Sie entweder die Text-Eigenschaft festlegen oder den Text zwischen dem Start- und dem Endtag des LinkButton-Steuerelements einfügen. Sie können entweder eine submit-Schaltfläche oder eine command-Schaltfläche erstellen.
Tipp
Das LinkButton-Steuerelement wird genauso dargestellt wie ein HyperLink-Steuerelement, verfügt jedoch über dieselbe Funktionalität wie ein Button-Steuerelement. Verwenden Sie das HyperLink-Steuerelement, wenn beim Klicken auf das Steuerelement eine Weiterleitung zu einer anderen Webseite erfolgen soll.
Mit einer submit-Schaltfläche ist kein Befehlsname verknüpft, und die Schaltfläche sendet lediglich die Webseite zurück an den Server. Standardmäßig handelt es sich bei LinkButton-Steuerelementen um submit-Steuerelemente. Sie können einen Ereignishandler für das Click-Ereignis bereitstellen, um die Aktionen, die beim Klicken auf die submit-Schaltfläche ausgeführt werden, programmgesteuert zu steuern.
Durch Festlegen der CommandName-Eigenschaft können Sie einen Befehlsnamen mit der Befehlsschaltfläche verknüpfen, z. B. Sort. Dadurch können Sie auf einer Webseite mehrere LinkButton-Steuerelemente erstellen und programmgesteuert bestimmen, auf welches LinkButton-Steuerelement geklickt wurde. Sie können auch die CommandArgument-Eigenschaft mit einer Befehlsschaltfläche verwenden, um zusätzliche Informationen zu dem auszuführenden Befehl anzugeben, z. B. Ascending. Sie können einen Ereignishandler für das Command-Ereignis bereitstellen, um die Aktionen, die beim Klicken auf die Befehlsschaltfläche ausgeführt werden, programmgesteuert zu steuern.
Tipp
Das LinkButton-Steuerelement stellt JavaScript im Clientbrowser dar. Im Clientbrowser muss JavaScript aktiviert sein, damit dieses Steuerelement ordnungsgemäß funktioniert. Weitere Informationen zu Clientskript finden Sie unter Clientskript in ASP.NET-Webseiten. Standardmäßig wird beim Klicken auf ein LinkButton-Steuerelement eine Seitenvalidierung durchgeführt. Bei der Seitenvalidierung wird festgestellt, ob die einem Validierungssteuerelement auf der Seite zugeordneten Eingabesteuerelemente allen Validierungsregeln entsprechen, die durch das Validierungssteuerelement festgelegt sind. Wenn dieses Verhalten für ein LinkButton-Steuerelement deaktiviert werden muss, z. B. für eine reset-Schaltfläche, legen Sie die CausesValidation-Eigenschaft auf false fest.
Warnung
Text wird erst dann in HTML codiert, wenn er im LinkButton-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.
Command-Schaltflächen (wie LinkButton-Steuerelemente) werden häufig in vorlagenbasierten Steuerelementen verwendet, um das übergeordnete Steuerelement über eine Aktion zu informieren. Derartige Aktionen sind beispielsweise das Auswählen in einem DataList-Steuerelement oder das Ändern des Modus in einem FormView-Steuerelement.
Ausführliche Informationen zu den Eigenschaften und Ereignissen von LinkButton-Webserversteuerelementen finden Sie in der Dokumentation zur LinkButton-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung eines LinkButton-Steuerelements zum Anzeigen einer Meldung, wenn der Benutzer auf das Steuerelement klickt.
<%@ 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>LinkButton Example</title>
<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 id="form1" runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Names="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<br />
<asp:Label id="Label1" 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>LinkButton Example</title>
<script language="C#" runat="server">
void LinkButton_Click(Object sender, EventArgs e)
{
Label1.Text="You clicked the link button";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Names="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<br />
<asp:Label id="Label1" 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>LinkButton Example</title>
<script language="JSCRIPT" runat="server">
function LinkButton_Click(sender : Object, e : EventArgs){
Label1.Text = "You clicked the link button"
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Names="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<br />
<asp:Label id="Label1" runat="server" />
</form>
</body>
</html>