GridViewCommandEventArgs GridViewCommandEventArgs GridViewCommandEventArgs GridViewCommandEventArgs Class

Definition

Stellt Daten für das RowCommand-Ereignis bereit.Provides data for the RowCommand event.

public ref class GridViewCommandEventArgs : System::Web::UI::WebControls::CommandEventArgs
public class GridViewCommandEventArgs : System.Web.UI.WebControls.CommandEventArgs
type GridViewCommandEventArgs = class
    inherit CommandEventArgs
Public Class GridViewCommandEventArgs
Inherits CommandEventArgs
Vererbung
GridViewCommandEventArgsGridViewCommandEventArgsGridViewCommandEventArgsGridViewCommandEventArgs

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie das GridViewCommandEventArgs -Objekt, das an die Ereignis Behandlungsmethode übermittelt wird, verwendet wird, um den Befehlsnamen der Schaltfläche zu ermitteln, die das Ereignis ausgelöst hatThe following example demonstrates how to use the GridViewCommandEventArgs object passed to the event-handling method to determine the command name of the button that raised the event.


<%@ 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 ContactsGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
    // If multiple buttons are used in a GridView control, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Add")
    {
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);

      // Retrieve the row that contains the button clicked 
      // by the user from the Rows collection.
      GridViewRow row = ContactsGridView.Rows[index];

      // Create a new ListItem object for the contact in the row.     
      ListItem item = new ListItem();
      item.Text = Server.HtmlDecode(row.Cells[2].Text) + " " +
        Server.HtmlDecode(row.Cells[3].Text);

      // If the contact is not already in the ListBox, add the ListItem 
      // object to the Items collection of the ListBox control. 
      if (!ContactsListBox.Items.Contains(item))
      {
        ContactsListBox.Items.Add(item);
      }
    }
  }    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView RowCommand Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>GridView RowCommand Example</h3>

      <table width="100%">
        <tr>
          <td style="width:50%">

            <asp:gridview id="ContactsGridView" 
              datasourceid="ContactsSource"
              allowpaging="true" 
              autogeneratecolumns="false"
              onrowcommand="ContactsGridView_RowCommand"
              runat="server">

              <columns>
                <asp:buttonfield buttontype="Link" 
                  commandname="Add" 
                  text="Add"/>
                <asp:boundfield datafield="ContactID" 
                  headertext="Contact ID"/>
                <asp:boundfield datafield="FirstName" 
                  headertext="First Name"/> 
                <asp:boundfield datafield="LastName" 
                  headertext="Last Name"/>
              </columns>

            </asp:gridview>

          </td>

          <td style="vertical-align:top; width:50%">

            Contacts: <br/>
            <asp:listbox id="ContactsListBox"
              runat="server" Height="200px" Width="200px"/>

          </td>
        </tr>
      </table>

      <!-- This example uses Microsoft SQL Server and connects    -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET  -->
      <!-- expression to retrieve the connection string value     -->
      <!-- from the Web.config file.                              -->
      <asp:sqldatasource id="ContactsSource"
        selectcommand="Select [ContactID], [FirstName], [LastName] From Person.Contact"
        connectionstring="<%$ ConnectionStrings:AdventureWorks_DataConnectionString%>" 
        runat="server"/>

    </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 ContactsGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)

    ' If multiple buttons are used in a GridView control, use the
    ' CommandName property to determine which button was clicked.
    If e.CommandName = "Add" Then
    
      ' Convert the row index stored in the CommandArgument
      ' property to an Integer.
      Dim index As Integer = Convert.ToInt32(e.CommandArgument)
            
      ' Retrieve the row that contains the button clicked 
      ' by the user from the Rows collection.
      Dim row As GridViewRow = ContactsGridView.Rows(index)
            
      ' Create a new ListItem object for the contact in the row.     
      Dim item As New ListItem()
      item.Text = Server.HtmlDecode(row.Cells(2).Text) & " " & _
        Server.HtmlDecode(row.Cells(3).Text)
            
      ' If the contact is not already in the ListBox, add the ListItem 
      ' object to the Items collection of the ListBox control. 
      If Not ContactsListBox.Items.Contains(item) Then
      
        ContactsListBox.Items.Add(item)
        
      End If
      
    End If
    
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>GridView RowCommand Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>GridView RowCommand Example</h3>

      <table width="100%">
        <tr>
          <td style="width:50%">

            <asp:gridview id="ContactsGridView" 
              datasourceid="ContactsSource"
              allowpaging="true" 
              autogeneratecolumns="false"
              onrowcommand="ContactsGridView_RowCommand"
              runat="server">

              <columns>
                <asp:buttonfield buttontype="Link" 
                  commandname="Add" 
                  text="Add"/>
                <asp:boundfield datafield="ContactID" 
                  headertext="Contact ID"/>
                <asp:boundfield datafield="FirstName" 
                  headertext="First Name"/> 
                <asp:boundfield datafield="LastName" 
                  headertext="Last Name"/>
              </columns>

            </asp:gridview>

          </td>

          <td style="vertical-align:top; width:50%">

            Contacts: <br/>
            <asp:listbox id="ContactsListBox"
              runat="server" Height="200px" Width="200px"/>

          </td>
        </tr>
      </table>

      <!-- This example uses Microsoft SQL Server and connects    -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET  -->
      <!-- expression to retrieve the connection string value     -->
      <!-- from the Web.config file.                              -->
      <asp:sqldatasource id="ContactsSource"
        selectcommand="Select [ContactID], [FirstName], [LastName] From Person.Contact"
        connectionstring="<%$ ConnectionStrings:AdventureWorks_DataConnectionString%>" 
        runat="server"/>

    </form>
  </body>
</html>

Hinweise

Das RowCommand -Ereignis wird ausgelöst, wenn GridView im-Steuerelement auf eine Schaltfläche geklickt wird.The RowCommand event is raised when a button within the GridView control is clicked. Dies ermöglicht es Ihnen, eine Ereignis Behandlungsmethode bereitzustellen, die immer dann eine benutzerdefinierte Routine ausführt, wenn dieses Ereignis auftritt.This allows you to provide an event-handling method that performs a custom routine whenever this event occurs.

Hinweis

Das GridView -Steuerelement löst auch andere spezialisierte Ereignisse aus, wenn auf bestimmte Schaltflächen CommandName geklickt wird (Schaltflächen mit der-Eigenschaft auf "Löschen", "Aktualisieren" und "Seite").The GridView control also raises other specialized events when certain buttons are clicked (buttons with the CommandName property set to "Delete", "Update", and "Page" for example). Wenn Sie eine dieser Schaltflächen verwenden, sollten Sie eine der vom Steuerelement bereitgestellten spezialisierten Ereignisse behandeln (z RowDeleted . b. oder RowDeleting).When using one of these buttons, you should consider handling one of the specialized events provided by the control (such as RowDeleted or RowDeleting).

Ein GridViewCommandEventArgs -Objekt wird an die Ereignis Behandlungsmethode übermittelt, mit der Sie den Befehlsnamen und das Befehls Argument der Schaltfläche, auf die geklickt wurde, bestimmen können.A GridViewCommandEventArgs object is passed to the event-handling method, which allows you to determine the command name and command argument of the button clicked. Name des Befehls und Befehlsargument ermitteln Sie mithilfe der CommandName und CommandArgument Eigenschaften bzw.To determine the command name and command argument, use the CommandName and CommandArgument properties, respectively. Mithilfe der CommandSource -Eigenschaft können Sie auch auf das Schaltflächen-Steuerelement zugreifen, das das Ereignis ausgelöst hat.You can also access the button control that raised the event by using the CommandSource property.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about how to handle events, see Handling and Raising Events.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von GridViewCommandEventArgsfinden Sie im GridViewCommandEventArgs -Konstruktor.For a list of initial property values for an instance of GridViewCommandEventArgs, see the GridViewCommandEventArgs constructor.

Konstruktoren

GridViewCommandEventArgs(GridViewRow, Object, CommandEventArgs) GridViewCommandEventArgs(GridViewRow, Object, CommandEventArgs) GridViewCommandEventArgs(GridViewRow, Object, CommandEventArgs) GridViewCommandEventArgs(GridViewRow, Object, CommandEventArgs)

Initialisiert eine neue Instanz der GridViewCommandEventArgs-Klasse unter Verwendung der angegebenen Zeile, der Quelle des Befehls und der Ereignisargumente.Initializes a new instance of the GridViewCommandEventArgs class using the specified row, source of the command, and event arguments.

GridViewCommandEventArgs(Object, CommandEventArgs) GridViewCommandEventArgs(Object, CommandEventArgs) GridViewCommandEventArgs(Object, CommandEventArgs) GridViewCommandEventArgs(Object, CommandEventArgs)

Initialisiert eine neue Instanz der GridViewCommandEventArgs-Klasse unter Verwendung der angegebenen Quelle des Befehls und der Ereignisargumente.Initializes a new instance of the GridViewCommandEventArgs class using the specified source of the command and event arguments.

Eigenschaften

CommandArgument CommandArgument CommandArgument CommandArgument

Ruft das Argument für den Befehl ab.Gets the argument for the command.

(Inherited from CommandEventArgs)
CommandName CommandName CommandName CommandName

Ruft den Namen des Befehls ab.Gets the name of the command.

(Inherited from CommandEventArgs)
CommandSource CommandSource CommandSource CommandSource

Ruft die Quelle des Befehls ab.Gets the source of the command.

Handled Handled Handled Handled

Ruft einen Wert ab, der angibt, ob das Steuerelement das Ereignis behandelt hat, oder legt diesen fest.Gets or sets a value that indicates whether the control has handled the event.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch