Esta documentación está archivada y no tiene mantenimiento.

CommandField.CancelText (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el título del botón de cancelación que se muestra en un campo CommandField.

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

public virtual string CancelText { get; set; }
/** @property */
public String get_CancelText()
/** @property */
public  void set_CancelText(String value)

public function get CancelText () : String
public function set CancelText (value : String)

Valor de propiedad

Tipo: System.String
Título del botón de cancelación de un campo CommandField. El valor predeterminado es "Cancelar".

Cuando la propiedad ButtonType de un campo CommandField esté establecida en ButtonType.Button o ButtonType.Link, utilice la propiedad CancelText para especificar el texto que se debe mostrar en el botón de cancelación.

ywd3h120.alert_note(es-es,VS.90).gifNota:

Como alternativa a texto en el botón de cancelación, también se puede mostrar una imagen, estableciendo primero la propiedad ButtonType en ButtonType.Image y después, la propiedad CancelImageUrl.

El valor de esta propiedad, cuando está establecida, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, vea LocalizableAttribute y Globalización y adaptación en ASP.NET.

En el ejemplo de código siguiente se muestra cómo utilizar la propiedad CancelText para especificar un título personalizado que se debe mostrar en el botón de cancelación en un campo CommandField 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"
            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>



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Mostrar: