GridView.EditIndex GridView.EditIndex GridView.EditIndex GridView.EditIndex Property

Definición

Obtiene o establece el índice de la fila que se va a editar.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

Valor de propiedad

Índice de base cero de la fila que se va a editar.The zero-based index of the row to edit. El valor predeterminado es -1, que indica que no se va a editar ninguna fila.The default is -1, which indicates that no row is being edited.

Excepciones

El índice especificado es menor que -1.The specified index is less than -1.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar EditIndex la propiedad para determinar qué fila se actualizó después de editarse GridView en un control.The following example demonstrates how to use the EditIndex property to determine which row was updated after it was edited in a GridView control. Se muestra un mensaje para indicar que la actualización se realizó correctamente.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>

Comentarios

El índice de fila está basado en cero (la primera fila es la fila cero).The row index is zero-based (the first row is row zero).

Esta propiedad se usa normalmente solo en los escenarios siguientes, que implican Controladores para eventos específicos:This property is typically used only in the following scenarios, which involve handlers for specific events:

  • Desea que el GridView control se abra en modo de edición para una fila específica la primera vez que se muestre la página.You want the GridView control to open in edit mode for a specific row the first time that the page is displayed. Para ello EditIndex , puede establecer la propiedad en el controlador para el Load evento de GridView la Page clase o del control.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.

  • Desea saber qué fila se editó una vez actualizada la fila.You want to know which row was edited after the row was updated. Para ello, puede recuperar el índice de la fila de la EditIndex propiedad en el RowUpdated controlador de eventos.To do this, you can retrieve the row index from the EditIndex property in the RowUpdated event handler.

  • Enlaza el GridView control a un origen de datos estableciendo la DataSource propiedad mediante programación.You are binding the GridView control to a data source by setting the DataSource property programmatically. En este caso, debe establecer la EditIndex propiedad en los RowEditing controladores RowCancelingEdit de eventos y.In this case you must set the EditIndex property in the RowEditing and RowCancelingEdit event handlers.

Si establece la EditIndex propiedad después de un postback o en los controladores para los eventos que se generan después Load del evento, GridView el control no puede entrar en el modo de edición de la fila especificada.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. Si lee el valor de esta propiedad en otros controladores de eventos, no se garantiza que el índice refleje la fila que se está editando.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.

Para determinar la fila en la que el usuario hizo clic en un botón Editar o un GridView hipervínculo en antes de que el control entre en el modo de edición, puede GridViewEditEventArgs recuperar el índice RowEditing de la fila de la NewEditIndex propiedad del objeto en el controlador de eventos. .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.

Para evitar que GridView el control entre en el modo de edición después de que un usuario haga clic en un botón Editar o un Cancel hipervínculo, true establezca GridViewEditEventArgs la RowEditing propiedad del objeto en en el controlador de eventos.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.

Se aplica a

Consulte también: