Exportar (0) Imprimir
Expandir todo

CommandField (Clase)

Representa un campo especial que muestra botones de comando para realizar operaciones de selección, edición, inserción o eliminación en un control enlazado a datos.

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

public class CommandField : ButtonFieldBase
public class CommandField extends ButtonFieldBase
public class CommandField extends ButtonFieldBase
No aplicable.

La clase CommandField es un campo especial que utilizan los controles enlazados a datos (por ejemplo, GridView y DetailsView) para mostrar botones de comando que realizan operaciones de eliminación, edición, inserción o selección. Los botones de comandos para realizar estas operaciones se pueden mostrar u ocultar utilizando las funciones que se mencionan en la siguiente tabla.

Propiedad

Descripción

ShowDeleteButton

Muestra u oculta un botón de eliminación en un campo CommandField para cada uno de los registros del control enlazado a datos. El botón de eliminación permite al usuario eliminar un registro del origen de datos.

ShowEditButton

Muestra u oculta un botón de edición en un campo CommandField para cada uno de los registros del control enlazado a datos. El botón de edición permite al usuario editar un registro del origen de datos. Cuando el usuario hace clic en el botón de edición para un registro concreto, dicho botón se reemplaza con los botones de actualización y cancelación. Todos los demás botones de comando también se ocultan.

ShowInsertButton

Muestra u oculta el botón de nuevo en un campo CommandField. El botón de nuevo permite al usuario insertar un nuevo registro del origen de datos. Cuando el usuario hace clic en el botón de nuevo, dicho botón se reemplaza con los botones de inserción y cancelación. Todos los demás botones de comando también se ocultan.

NotaNota:

Esta propiedad sólo se aplica a controles enlazados a datos que admiten operaciones de inserción, por ejemplo el control DetailsView.

ShowSelectButton

Muestra u oculta un botón de selección en un campo CommandField para cada uno de los registros del control enlazado a datos. El botón de selección permite al usuario seleccionar un registro en el control enlazado a datos.

Además, el botón de cancelación que se muestra cuando un registro se encuentra en modo de inserción o edición se puede mostrar u ocultar estableciendo la propiedad ShowCancelButton.

NotaNota:

Cuando se utiliza un control enlazado a datos combinado con un control de origen de datos (como un control SqlDataSource), el control enlazado a datos puede aprovechar las capacidades del control de origen de datos y proporcionar funciones automáticas de eliminación, actualización e inserción. Para otros orígenes de datos, es necesario proporcionar las rutinas para realizar estas operaciones durante los eventos adecuados del control enlazado a datos.

El campo CommandField tiene un aspecto diferente en función del control enlazado a datos en que se utilice. Por ejemplo, el control GridView muestra un campo CommandField como columna, mientras que el control DetailsView lo muestra como fila.

Para especificar el tipo de botón que se debe mostrar, utilice la propiedad ButtonType. Cuando la propiedad ButtonType se establece en ButtonType.Button o en ButtonType.Link, se puede especificar el texto que se debe mostrar para los botones, mediante el establecimiento de las propiedades que se muestran en la siguiente tabla.

Propiedad

Descripción

CancelText

Título del botón de cancelación.

DeleteText

Título del botón de eliminación.

EditText

Título del botón de edición.

InsertText

Título del botón de inserción.

NotaNota:

Esta propiedad sólo se aplica a controles enlazados a datos que admiten operaciones de inserción, por ejemplo el control DetailsView.

NewText

Título del botón de nuevo.

NotaNota:

Esta propiedad sólo se aplica a controles enlazados a datos que admiten operaciones de inserción, por ejemplo el control DetailsView.

SelectText

Título del botón de selección.

UpdateText

Título del botón de actualización.

En lugar de mostrar un botón de comando o un botón de vínculo, se puede mostrar un botón de imagen mediante el establecimiento de la propiedad ButtonType en ButtonType.Image y estableciendo después las propiedades que se muestran en la siguiente tabla.

Propiedad

Descripción

CancelImageUrl

Imagen que se va a mostrar en el botón de cancelación.

DeleteImageUrl

Imagen que se va a mostrar en el botón de eliminación.

EditImageUrl

Imagen que se va a mostrar en el botón de edición.

InsertText

Imagen que se va a mostrar en el botón de inserción.

NotaNota:

Esta propiedad sólo se aplica a controles enlazados a datos que admiten operaciones de inserción, por ejemplo el control DetailsView.

NewImageUrl

Imagen que se va a mostrar en el botón de nuevo.

NotaNota:

Esta propiedad sólo se aplica a controles enlazados a datos que admiten operaciones de inserción, por ejemplo el control DetailsView.

SelectImageUrl

Imagen que se va a mostrar en el botón de selección.

UpdateImageUrl

Imagen que se va a mostrar en el botón de actualización.

De manera predeterminada, cuando el usuario hace clic en un botón de un campo CommandField, se realiza la validación de todos los controles de validación de la página. Para evitar que la validación tenga lugar al hacer clic en un botón, establezca la propiedad CausesValidation en false.

Puede ocultar un campo CommandField de un control enlazado a datos estableciendo la propiedad Visible en false.

El campo CommandField le permite personalizar sus secciones de encabezado y pie de página. Para mostrar un título en las secciones de encabezado o pie de página, establezca la propiedad HeaderText o la propiedad FooterText, respectivamente. En lugar de mostrar texto en la sección de encabezado, puede mostrar una imagen estableciendo la propiedad HeaderImageUrl. Para ocultar la sección de encabezado de un objeto CommandField, establezca la propiedad ShowHeader en false.

NotaNota:

Algunos controles enlazados a datos (como el control GridView) sólo pueden mostrar u ocultar la sección de encabezado completa del control. Estos controles enlazados a datos no admiten la propiedad ShowHeader para un solo campo de botón. Para mostrar u ocultar la sección de encabezado completa de un control enlazado a datos (si está disponible), utilice la propiedad ShowHeader del control.

También puede personalizar el aspecto del objeto CommandField (color de la fuente, color de fondo, etc.) estableciendo las propiedades de estilo de las distintas partes del campo. En la siguiente tabla se muestran las diferentes propiedades de estilo.

Propiedad de estilo

Descripción

ControlStyle

Configuración de estilo de los controles de servidor Web secundarios del objeto CommandField.

FooterStyle

Configuración de estilo de la sección de pie de página del objeto CommandField.

HeaderStyle

Configuración de estilo de la sección de encabezado del objeto CommandField.

ItemStyle

Configuración de estilo de los elementos de datos del objeto CommandField.

En el ejemplo de código siguiente se muestra cómo utilizar un campo CommandField para mostrar controles para editar un registro de un 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </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)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


En el ejemplo de código siguiente se muestra cómo utilizar las propiedades CancelText, EditText y UpdateText para personalizar el texto de los controles de edición.


<%@ 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </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)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


  • AspNetHostingPermission  para su funcionamiento en un entorno alojado en host. Valor de petición: LinkDemand; valor de permiso: Minimal.
  • AspNetHostingPermission  para su funcionamiento en un entorno alojado en host. Valor de petición: InheritanceDemand; valor de permiso: Minimal.

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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