LinkButton-Webserversteuerelement
Erstellt eine Schaltfläche als Hyperlink auf einer Web Forms-Seite.
<asp:LinkButtonid="LinkButton1" Text="label" Command="Command" CommandArgument="CommandArgument" CausesValidation="true | false" OnClick="OnClickMethod" runat="server"/>
or
<asp:LinkButtonid="LinkButton1" Command="Command" CommandArgument="CommandArgument" CausesValidation="true | false" OnClick="OnClickMethod" runat="server"/> Text</asp:LinkButton>
Hinweise
Mit Hilfe des LinkButton-Steuerelements wird eine Schaltfläche in Form eines Hyperlinks auf einer Web Forms-Seite erstellt. Geben Sie den im LinkButton-Steuerelement anzuzeigenden Text an, indem Sie entweder die Text-Eigenschaft setzen oder den Text zwischen das öffnende und das schließende Tag des LinkButton-Steuerelements platzieren. Sie können entweder eine submit-Schaltfläche oder eine command-Schaltfläche erstellen.
Hinweis Das LinkButton-Steuerelement hat das gleiche Erscheinungsbild wie das HyperLink-Steuerelement, weist jedoch die gleichen Funktionen wie ein Button-Steuerelement auf. Verwenden Sie das HyperLink-Steuerelement, wenn beim Klicken auf das Steuerelement eine Verknüpfung zu einer anderen Webseite gesichtet werden soll.
Mit einer submit-Schaltfläche ist kein Befehlsname verknüpft, und die Schaltfläche sendet lediglich die Webseite zurück an den Server. Ein LinkButton-Steuerelement ist standardmäßig eine submit-Schaltfläche. Sie können einen Ereignishandler für das Click-Ereignis bereitstellen, um die beim Klicken auf die submit-Schaltfläche ausgeführten Aktionen programmgesteuert zu steuern.
Durch Setzen der CommandName-Eigenschaft können Sie einen Befehlsnamen mit der command-Schaltfläche verknüpfen, z. B. Sortieren. Dadurch können Sie auf einer Webseite mehrere LinkButton-Steuerelemente erstellen und programmgesteuert ermitteln, auf welches LinkButton-Steuerelement geklickt wird. Sie können auch die CommandArgument-Eigenschaft für eine command-Schaltfläche verwenden, um zusätzliche Informationen zu dem auszuführenden Befehl bereitzustellen, z. B. Aufsteigend. 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.
Hinweis Das LinkButton-Steuerelement gibt JavaScript auf dem Clientbrowser wieder. Im Clientbrowser muss JavaScript aktiviert sein, damit dieses Steuerelement ordnungsgemäß funktioniert. Weitere Informationen über Clientskripts finden Sie unter Clientskript in Web Forms-Seiten.
Standardmäßig wird beim Klicken auf ein LinkButton-Steuerelement eine Seitenüberprüfung durchgeführt. Bei der Seitenüberprüfung wird festgestellt, ob die einem Steuerelement für die Gültigkeitsprüfung auf der Seite zugeordneten Eingabesteuerelemente allen Überprüfungsregeln entsprechen, die durch das Steuerelement für die Gültigkeitsprüfung festgelegt sind. Wenn Sie ein LinkButton-Steuerelement verwenden, für das dieses Verhalten deaktiviert werden muss, z. B. eine Schaltfläche Zurücksetzen, setzen Sie die CausesValidation-Eigenschaft auf false.
Vorsicht Text wird nicht in HTML codiert, bevor 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 geprüft werden, um die Sicherheit zu gewährleisten.
Weitere Informationen zu den Eigenschaften und Ereignissen des LinkButton-Webserversteuerelements finden Sie unter LinkButton-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie mit einem LinkButton-Steuerelement eine Meldung angezeigt wird, wenn der Benutzer auf das Steuerelement klickt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script 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>
[C#]
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void LinkButton1_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="LinkButton1_Click"
runat="server"/>
<asp:Label id=Label1
runat=server />
</form>
</body>
</html>