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

DetailsView.AutoGenerateInsertButton (Propiedad)

Actualización: noviembre 2007

Obtiene o establece un valor que indica si los controles integrados que permiten insertar un nuevo registro se muestran en un control DetailsView.

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

public virtual bool AutoGenerateInsertButton { get; set; }
/** @property */
public boolean get_AutoGenerateInsertButton()
/** @property */
public  void set_AutoGenerateInsertButton(boolean value)

public function get AutoGenerateInsertButton () : boolean
public function set AutoGenerateInsertButton (value : boolean)
<asp:DetailsView AutoGenerateInsertButton="True|False" />

Valor de propiedad

Tipo: System.Boolean
Es true para mostrar los controles integrados que permiten insertar un nuevo registro; de lo contrario, false. El valor predeterminado es false.

Cuando un control de origen de datos que admite inserciones se enlaza a un control DetailsView, el control DetailsView puede aprovechar las funciones del control de origen de datos y proporcionar la funcionalidad de inserción automática.

2tybba43.alert_note(es-es,VS.90).gifNota:

Para que un control de origen de datos pueda insertar datos, su propiedad SqlDataSource.InsertCommand se debe establecer mediante una instrucción de consulta Insert.

Cuando la propiedad AutoGenerateInsertButton se establece en true, se muestra automáticamente un campo de fila CommandField con un botón Nuevo en el control DetailsView. Al hacer clic en el botón Nuevo, ese control DetailsView entra en modo de inserción. En el modo de inserción, cada campo enlazado que no es de sólo lectura muestra el control de entrada adecuado, como, por ejemplo, un control TextBox, para el tipo de datos del campo. Esto permite al usuario especificar el valor del campo para el nuevo registro.

Al hacer clic, el botón Nuevo se reemplaza por un botón Insertar y un botón Cancelar. Al hacer clic en el botón Insertar, se inserta el nuevo registro en el origen de datos y se devuelve el control al modo especificado por la propiedad DefaultMode. Al hacer clic en el botón Cancelar, se abandona la operación de inserción y se devuelve el control al modo predeterminado.

2tybba43.alert_note(es-es,VS.90).gifNota:

Para colocar una fila en modo de inserción mediante programación, utilice el método ChangeMode.

Puede controlar el aspecto de una registro que está en modo de inserción mediante la propiedad InsertRowStyle. Entre las opciones de configuración comunes se incluyen un color de fondo y un color de primer plano personalizados y las propiedades de fuente.

El control DetailsView proporciona varios eventos que puede utilizar para realizar una acción personalizada cuando se inserta un registro. La tabla siguiente enumera los eventos disponibles.

Evento

Description

ItemInserted

Se produce al hacer clic en el botón Insertar, pero después de que el control DetailsView inserte el registro. Este evento suele utilizarse para comprobar los resultados de la operación de inserción.

ItemInserting

Se produce al hacer clic en el botón Insertar, pero antes de que el control DetailsView inserte el registro. Este evento suele utilizarse para cancelar la operación de inserción.

ModeChanged

Se produce después de que el control DetailsView cambie de modo.

ModeChanging

Se produce antes de que el control DetailsView cambie de modo. Este evento se suele utilizar para cancelar el cambio de modo.

El valor de AutoGenerateInsertButton se almacena en el estado de vista.

El ejemplo de código siguiente muestra cómo utilizar la propiedad AutoGenerateInsertButton para mostrar los controles integrados que permiten insertar un nuevo registro en un control DetailsView.


<%@ 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>DetailsView AutoGenerateInsertButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">

      <h3>DetailsView AutoGenerateInsertButton Example</h3>

        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">

          <headerstyle backcolor="Navy"
            forecolor="White"/>

        </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="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] 
            From [Customers]">
        </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: