LinkButton.OnCommand(CommandEventArgs) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löst das Command-Ereignis des LinkButton-Steuerelements aus.
protected:
virtual void OnCommand(System::Web::UI::WebControls::CommandEventArgs ^ e);
protected virtual void OnCommand (System.Web.UI.WebControls.CommandEventArgs e);
abstract member OnCommand : System.Web.UI.WebControls.CommandEventArgs -> unit
override this.OnCommand : System.Web.UI.WebControls.CommandEventArgs -> unit
Protected Overridable Sub OnCommand (e As CommandEventArgs)
Parameter
Ein CommandEventArgs, das die Ereignisdaten enthält.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie einen Handler für das Command Ereignis angeben und codieren, um anzuzeigen, auf welches LinkButton Steuerelement geklickt wird.
<%@ 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 Command Event Example</title>
<script language="C#" runat="server">
void LinkButton_Command(Object sender, CommandEventArgs e)
{
Label1.Text = "You chose: " + e.CommandName + " Item " + e.CommandArgument;
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton Command Event Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Order Item 10001"
CommandName="Order"
CommandArgument="10001"
OnCommand="LinkButton_Command"
runat="server"/>
<br />
<asp:LinkButton id="LinkButton2"
Text="Order Item 10002"
CommandName="Order"
CommandArgument="10002"
OnCommand="LinkButton_Command"
Runat="server"/>
<br />
<br />
<asp:Label id="Label1" runat="server"/>
</form>
</body>
</html>
<%@ 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 Command Event Example</title>
<script language="VB" runat="server">
Sub LinkButton_Command(sender As Object, e As CommandEventArgs)
Label1.Text = "You chose: " & e.CommandName & " Item " & _
e.CommandArgument
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton Command Event Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Order Item 10001"
CommandName="Order"
CommandArgument="10001"
OnCommand="LinkButton_Command"
runat="server"/>
<br />
<asp:LinkButton id="LinkButton2"
Text="Order Item 10002"
CommandName="Order"
CommandArgument="10002"
OnCommand="LinkButton_Command"
Runat="server"/>
<br />
<br />
<asp:Label id="Label1" runat="server"/>
</form>
</body>
</html>
Hinweise
Das Command Ereignis wird ausgelöst, wenn auf das LinkButton Steuerelement geklickt wird. Dieses Ereignis wird häufig verwendet, wenn ein Befehlsname, z Sort
. B. , dem LinkButton Steuerelement zugeordnet ist. Dadurch können Sie mehrere LinkButton Steuerelemente auf einer Webseite erstellen und programmgesteuert bestimmen, auf welches LinkButton Steuerelement geklickt wird.
Hinweis
Das Command -Ereignis wird über die Steuerelementhierarchie in Form von BubbleEvent
ausgelöst.
Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.
Mit der OnCommand-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Vererber
Wenn Sie OnCommand(CommandEventArgs) in einer abgeleiteten Klasse überschreiben, müssen Sie die OnCommand(CommandEventArgs)-Methode der Basisklasse aufrufen, damit registrierte Delegaten das Ereignis empfangen.