ButtonField.CommandName Eigenschaft
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.
Ruft eine Zeichenfolge ab, die die Aktion darstellt, die beim Klicken auf eine Schaltfläche in einem ButtonField-Objekt ausgeführt werden soll, oder legt diese fest.
public:
virtual property System::String ^ CommandName { System::String ^ get(); void set(System::String ^ value); };public virtual string CommandName { get; set; }member this.CommandName : string with get, setPublic Overridable Property CommandName As StringEigenschaftswert
Der Name der Aktion, die ausgeführt werden soll, wenn auf eine Schaltfläche im ButtonField geklickt wird.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der CommandName Eigenschaft einen Befehlsnamen für die Schaltflächen in einem ButtonField Objekt eines GridView Steuerelements angeben.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
{
// If multiple ButtonField column fields are used, use the
// CommandName property to determine which button was clicked.
if(e.CommandName=="Select")
{
// Convert the row index stored in the CommandArgument
// property to an Integer.
int index = Convert.ToInt32(e.CommandArgument);
// Get the last name of the selected author from the appropriate
// cell in the GridView control.
GridViewRow selectedRow = CustomersGridView.Rows[index];
TableCell contactName = selectedRow.Cells[1];
string contact = contactName.Text;
// Display the selected author.
Message.Text = "You selected " + contact + ".";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ButtonField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ButtonField Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"
AssociatedControlID="CustomersGridView"/>
<!-- Populate the Columns collection declaratively. -->
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
onrowcommand="CustomersGridView_RowCommand"
runat="server">
<columns>
<asp:buttonfield buttontype="Button"
commandname="Select"
headertext="Select Customer"
text="Select"/>
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="ContactName"
headertext="Contact Name"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
' If multiple ButtonField column fields are used, use the
' CommandName property to determine which button was clicked.
If e.CommandName = "Select" Then
' Convert the row index stored in the CommandArgument
' property to an Integer.
Dim index As Integer = Convert.ToInt32(e.CommandArgument)
' Get the last name of the selected author from the appropriate
' cell in the GridView control.
Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
Dim contactCell As TableCell = selectedRow.Cells(1)
Dim contact As String = contactCell.Text
' Display the selected author.
Message.Text = "You selected " & contact & "."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ButtonField Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>ButtonField Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"
AssociatedControlID="CustomersGridView"/>
<!-- Populate the Columns collection declaratively. -->
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
onrowcommand="CustomersGridView_RowCommand"
runat="server">
<columns>
<asp:buttonfield buttontype="Button"
commandname="Select"
headertext="Select Customer"
text="Select"/>
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="ContactName"
headertext="Contact Name"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Hinweise
Verwenden Sie die CommandName Eigenschaft, um einen Befehlsnamen, z "Add" . B. oder "Remove", den Schaltflächen im ButtonField Objekt zuzuordnen. Sie können die CommandName Eigenschaft auf eine beliebige Zeichenfolge festlegen, die die auszuführende Aktion identifiziert, wenn auf die Befehlsschaltfläche geklickt wird. Anschließend können Sie den Befehlsnamen in einem Ereignishandler programmgesteuert bestimmen und die entsprechenden Aktionen ausführen.
Hinweis
Alle Schaltflächen in einem ButtonField Objekt teilen denselben Befehlsnamen.
Datengebundene Steuerelemente erkennen bestimmte Befehlsnamen und lösen automatisch die entsprechenden Ereignisse für das Steuerelement aus. Die folgenden Befehlsnamen werden erkannt:
"Cancel""Delete""Edit""Insert""New""Page""Select""Sort""Update"
Legen Sie zum Aufrufen der Seitenverwaltung den CommandName "Page" Wert auf und das CommandArgument enthaltene Button Steuerelement auf "First", "Prev"``"Last", , "Next", oder eine Seitenzahl fest. Da für ein ButtonField Steuerelement jedoch CommandArgument immer der ganzzahlige Zeilenindex ist, eignet sich ein ButtonField Steuerelement nicht für das Aufrufen von Seiten. Ebenso kann die Sortierung aufgerufen werden, indem Sie den Wert auf "Sort""CommandName" festlegen, ist die CommandArgument Eigenschaft für ein ButtonField Steuerelement immer der Ganzzahlzeilenindex. Aus diesem Grund eignet sich ein ButtonField Steuerelement nicht für das Aufrufen der Sortierung. Für benutzerdefinierte Befehlsnamen, z "Add" . B. und "Remove", müssen Sie den Ereigniscode schreiben, um den Befehlsnamen zu überprüfen und eine benutzerdefinierte Aktion auszuführen. Weitere Informationen finden Sie unter DataControlCommands.
Hinweis
Nicht alle Befehlsnamen werden von allen datengebundenen Steuerelementen erkannt. Wird beispielsweise "New" vom GridView Steuerelement nicht erkannt und "Select" wird vom DetailsView Steuerelement nicht erkannt.
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.