GridView.EditIndex Eigenschaft

Definition

Ruft den Wert des Indexes für die zu bearbeitende Zeile ab oder legt ihn fest.Gets or sets the index of the row to edit.

public:
 virtual property int EditIndex { int get(); void set(int value); };
public virtual int EditIndex { get; set; }
member this.EditIndex : int with get, set
Public Overridable Property EditIndex As Integer

Eigenschaftswert

Der auf 0 basierende Index der zu bearbeitenden Zeile.The zero-based index of the row to edit. Der Standardwert ist -1 und bedeutet, dass keine Zeile bearbeitet wird.The default is -1, which indicates that no row is being edited.

Ausnahmen

Der angegebene Index ist kleiner als -1.The specified index is less than -1.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die EditIndex -Eigenschaft verwendet wird, um zu bestimmen, welche Zeile aktualisiert wurde GridView , nachdem Sie in einem-Steuerelement bearbeitet wurde.The following example demonstrates how to use the EditIndex property to determine which row was updated after it was edited in a GridView control. Eine Meldung wird angezeigt, die anzeigt, dass das Update erfolgreich war.A message is displayed to indicate that the update was successful.


<%@ 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)
  {
    
    // Clear the message label when the user enters edit mode.
    if (e.CommandName == "Edit")
    {
      Message.Text = "";
    }
    
  }

  void CustomersGridView_RowUpdated(Object sender, GridViewUpdatedEventArgs e)
    {
   
        // The update operation was successful. Retrieve the row being edited.
        int index = CustomersGridView.EditIndex;
        GridViewRow row = CustomersGridView.Rows[index];
        
        // Notify the user that the update was successful.
        Message.Text = "Updated record " + row.Cells[1].Text + ".";
    
    }

  void CustomersGridView_RowCancelingEdit(Object sender, GridViewCancelEditEventArgs e)
    {
   
        // The update operation was canceled. Display the appropriate message.
        Message.Text = "Update operation canceled.";
    
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView Rows Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Rows Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                
      <br/>    
            
      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView"
        allowpaging="true" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"
        onrowcommand="CustomersGridView_RowCommand"
        onrowupdated="CustomersGridView_RowUpdated"
        onrowcancelingedit="CustomersGridView_RowCancelingEdit"  
        runat="server">
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        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)
    
    ' Clear the message label when the user enters edit mode.
    If e.CommandName = "Edit" Then
      Message.Text = ""
    End If
    
  End Sub
  
  Sub CustomersGridView_RowUpdated(ByVal sender As Object, ByVal e As GridViewUpdatedEventArgs)
   
    ' The update operation was successful. Retrieve the row being edited.
    Dim index As Integer = CustomersGridView.EditIndex
    Dim row As GridViewRow = CustomersGridView.Rows(index)
        
    ' Notify the user that the update was successful.
    Message.Text = "Updated record " & row.Cells(1).Text + "."
    
  End Sub

  Sub CustomersGridView_RowCancelingEdit(ByVal sender As Object, ByVal e As GridViewCancelEditEventArgs)
   
    ' The update operation was canceled. Display the appropriate message.
    Message.Text = "Update operation canceled."
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView Rows Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Rows Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                
      <br/>    
            
      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView"
        allowpaging="true" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"
        onrowcommand="CustomersGridView_RowCommand"
        onrowupdated="CustomersGridView_RowUpdated"
        onrowcancelingedit="CustomersGridView_RowCancelingEdit"  
        runat="server">
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Hinweise

Der Zeilen Index ist NULL basiert (die erste Zeile ist Zeile NULL).The row index is zero-based (the first row is row zero).

Diese Eigenschaft wird in der Regel nur in den folgenden Szenarien verwendet, die Handler für bestimmte Ereignisse einschließen:This property is typically used only in the following scenarios, which involve handlers for specific events:

  • Sie möchten, GridView dass das Steuerelement im Bearbeitungsmodus für eine bestimmte Zeile geöffnet wird, wenn die Seite zum ersten Mal angezeigt wird.You want the GridView control to open in edit mode for a specific row the first time that the page is displayed. Zu diesem Zweck können Sie EditIndex die-Eigenschaft im-Handler für das Load -Ereignis der Page -Klasse oder des GridView -Steuer Elements festlegen.To do this, you can set the EditIndex property in the handler for the Load event of the Page class or of the GridView control.

  • Sie möchten wissen, welche Zeile nach dem Aktualisieren der Zeile bearbeitet wurde.You want to know which row was edited after the row was updated. Zu diesem Zweck können Sie den Zeilen Index aus der EditIndex -Eigenschaft RowUpdated im-Ereignishandler abrufen.To do this, you can retrieve the row index from the EditIndex property in the RowUpdated event handler.

  • Sie binden das GridView Steuerelement an eine Datenquelle, indem Sie DataSource die-Eigenschaft Programm gesteuert festlegen.You are binding the GridView control to a data source by setting the DataSource property programmatically. In diesem Fall müssen Sie die EditIndex -Eigenschaft in den RowEditing Ereignis Handlern und RowCancelingEdit festlegen.In this case you must set the EditIndex property in the RowEditing and RowCancelingEdit event handlers.

Wenn Sie die EditIndex -Eigenschaft nach einem Postback oder in Handlern für Ereignisse festlegen, die später als das Load -Ereignis ausgelöst GridView werden, wird das Steuerelement möglicherweise nicht in den Bearbeitungsmodus für die angegebene Zeile eingegeben.If you set the EditIndex property after a postback or in handlers for events that are raised later than the Load event, the GridView control might not enter edit mode for the specified row. Wenn Sie den Wert dieser Eigenschaft in anderen Ereignis Handlern lesen, kann der Index nicht sicher sein, dass die Zeile, die bearbeitet wird, angezeigt wird.If you read the value of this property in other event handlers, the index is not guaranteed to reflect the row that is being edited.

Sie können den Zeilen Index aus GridViewEditEventArgs der NewEditIndex -Eigenschaft des-Objekts im RowEditing Ereignishandler abrufen GridView , um zu bestimmen, in welcher Zeile der Benutzer auf eine Bearbeitungs Schaltfläche oder einen Hyperlink in geklickt hat, bevor das Steuerelement in den Bearbeitungsmodus wechselt. .To determine which row the user has clicked an Edit button or hyperlink in before the GridView control enters edit mode, you can retrieve the row index from the NewEditIndex property of the GridViewEditEventArgs object in the RowEditing event handler.

Um zu verhindern GridView , dass das Steuerelement in den Bearbeitungsmodus wechselt, **** nachdem ein Benutzer auf eine Schaltfläche Cancel oder einen Hyperlink geklickt hat true , legen RowEditing Sie GridViewEditEventArgs die-Eigenschaft des-Objekts im Ereignishandler auf fest.To prevent the GridView control from entering edit mode after a user has clicked an Edit button or hyperlink, set the Cancel property of the GridViewEditEventArgs object to true in the RowEditing event handler.

Gilt für:

Siehe auch