Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

CommandField.ShowInsertButton (Propiedad)

Obtiene o establece un valor que indica si en un campo CommandField se muestra un botón de nuevo.

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

public virtual bool ShowInsertButton { get; set; }

Valor de propiedad

Tipo: System.Boolean
true para mostrar un botón de nuevo en un campo CommandField; en caso contrario, false. El valor predeterminado es false.

Utilice la propiedad ShowInsertButton para especificar si se debe mostrar un botón de nuevo en un campo CommandField. El botón de nuevo sólo se muestra una vez en el campo CommandField y permite al usuario agregar un nuevo registro al origen de datos.

NotaNota

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

Cuando el usuario hace clic en el botón de nuevo, se muestran controles de entrada de datos para cada uno de los campos mostrados en el control enlazado a datos, lo que permite al usuario proporcionar los valores del nuevo registro. El botón de nuevo se reemplaza con los botones de inserción y cancelación, y se ocultan todos los demás botones de comando del campo CommandField. Si se hace clic en el botón de inserción se agrega el registro al origen de datos, mientras que si se hace clic en el botón de cancelación se cancela la operación.

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 la función de inserción automática. Para otros orígenes de datos, es necesario proporcionar las rutinas para realizar la operación de inserción durante los eventos adecuados del control enlazado a datos.

Cuando la propiedad ButtonType de un campo CommandField esté establecida en ButtonType.Button o ButtonType.Link, utilice la propiedad NewText para especificar el texto que se debe mostrar en el botón de nuevo. Si lo prefiere, puede hacer que se muestre una imagen estableciendo primero la propiedad ButtonType en ButtonType.Image y estableciendo después la propiedad NewImageUrl.

En el siguiente ejemplo de código se muestra cómo utilizar la propiedad ShowInsertButton para que aparezca un botón de nuevo en un control DetailsView, que permite al usuario agregar un nuevo registro al origen de datos.



<%@ 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:detailsview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneraterows="false"
        datakeynames="CustomerID"  
        allowpaging="true" 
        runat="server">

        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="CompanyName"/>
          <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"/>
          <asp:commandfield showinsertbutton="true"
            showheader="true"
            headertext="Add Customer"/>
        </fields>

      </asp:detailsview>

      <!-- 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]"
        insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>

    </form>
  </body>
</html>



.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: