Exportar (0) Imprimir
Expandir todo

GridView.AutoGenerateEditButton (Propiedad)

Obtiene o establece un valor que indica si una columna de campo CommandField con un botón Editar para cada fila de datos se agrega automáticamente a un control GridView.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

public virtual bool AutoGenerateEditButton { get; set; }
/** @property */
public boolean get_AutoGenerateEditButton ()

/** @property */
public void set_AutoGenerateEditButton (boolean value)

public function get AutoGenerateEditButton () : boolean

public function set AutoGenerateEditButton (value : boolean)

No aplicable.

Valor de propiedad

Es true para agregar automáticamente una columna de campo CommandField con un botón Editar para cada fila de datos; de lo contrario, es false. El valor predeterminado es false.

Cuando un control de origen de datos que admite la actualización se enlaza a un control GridView, el control GridView puede sacar provecho de las funciones del control de origen de datos y proporcionar la funcionalidad de actualización automática.

NotaNota:

Para que un control de origen de datos actualice los datos, se debe configurar para actualizar datos. Para configurar un control de origen de datos para actualizar registros, consulte la documentación existente de ese control de origen de datos.

Cuando la propiedad AutoGenerateEditButton se establece en true, se agrega automáticamente una columna (representada por un objeto CommandField) con un botón Editar para cada fila de datos al control GridView. Al hacer clic en un botón Editar para una fila, esa fila se coloca en modo de edición. Cuando una fila está en modo de edición, cada campo de columna de la fila que no es de sólo lectura muestra el control de entrada adecuado, como un control TextBox, para el tipo de datos del campo. Esto permite al usuario modificar el valor del campo.

Al hacer clic, el botón Editar se reemplaza con un botón Actualizar y un botón Cancelar. Al hacer clic en el botón Actualizar, se actualiza la fila del origen de datos con cualquier cambio de valor y se devuelve al modo de presentación. Al hacer clic en el botón Cancelar, se abandona cualquier cambio de valor y se devuelve la fila al modo de presentación.

NotaNota:

Puede colocar una fila en modo de edición mediante programación si establece la propiedad EditIndex con el índice de la fila. Para salir del modo de edición mediante programación, establezca la propiedad EditIndex en -1.

Al utilizar la funcionalidad de actualización integrada, debe establecer la propiedad DataKeyNames con una lista de nombres de campos separados por coma para identificar el campo o los campos de clave principal del origen de datos; de lo contrario, la funcionalidad de actualización integrada no podrá actualizar el registro correcto. Al utilizar columnas de campos generados automáticamente (estableciendo la propiedad AutoGenerateColumns en true), el control GridView garantiza al instante que las columnas de campos generados automáticamente que corresponden al campo o los campos especificados en la propiedad DataKeyNames son de sólo lectura.

Puede controlar la apariencia de una fila que está en modo de edición por medio de la propiedad EditRowStyle. Entre las opciones de configuración comunes se incluyen color de fondo, color de primer plano y propiedades de fuente personalizados.

El control GridView proporciona varios eventos que puede utilizar para realizar una acción personalizada cuando se actualiza una fila. La tabla siguiente enumera los eventos disponibles.

Evento

Descripción

RowCancelingEdit

Se produce cuando se hace clic en el botón Cancelar de una fila, pero antes de que el control GridView cancele el modo de edición. Este evento suele utilizarse para detener la operación de cancelación.

RowEditing

Se produce cuando se hace clic en el botón Editar de una fila, pero antes de que el control GridView entre en el modo de edición. Este evento suele utilizarse para cancelar la operación de edición.

RowUpdated

Se produce cuando se hace clic en el botón Actualizar de una fila, pero después de que el control GridView actualice la fila. Este evento suele utilizarse para comprobar los resultados de la operación de actualización.

RowUpdating

Se produce cuando se hace clic en el botón Actualizar de una fila, pero antes de que el control GridView actualice la fila. Este evento suele utilizarse para cancelar la operación de actualización.

En el ejemplo de código siguiente se muestra cómo utilizar la propiedad AutoGenerateEditButton para habilitar la característica de edición automática del control GridView.


<%@ Page language="C#" %>

<!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 runat="server">
    <title>GridView Edit Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Edit Example</h3>

      <!-- 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" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogeneratedeletebutton="true"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"  
        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>


Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar:
© 2014 Microsoft