Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.

Traducción

Original

Este tema aún no ha recibido ninguna valoración - Valorar este tema

DetailsView.AutoGenerateInsertButton (Propiedad)

.NET Framework 4.5

Otras versiones

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)

Sintaxis

C++

public virtual bool AutoGenerateInsertButton { get; set; }

ASP.NET

<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.

Comentarios

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.

Nota
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.

Nota
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	Descripción
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.

Ejemplos

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>

Información de versión

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.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.

Vea también