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

DetailsViewInsertEventArgs (Clase)

Proporciona datos para el evento ItemInserting.

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

public class DetailsViewInsertEventArgs : CancelEventArgs
public class DetailsViewInsertEventArgs extends CancelEventArgs
public class DetailsViewInsertEventArgs extends CancelEventArgs
No aplicable.

El control DetailsView provoca el evento ItemInserting cuando se hace clic en un botón Insertar (botón con su propiedad CommandName establecida en "Insert") dentro del control, pero antes de que el control DetailsView inserte el registro. Esto le permite proporcionar un controlador de eventos que realiza una rutina personalizada, por ejemplo la codificación HTML de los valores de un registro, antes de insertarlo en el origen de datos, cada vez que ocurra este evento.

Se pasa un objeto DetailsViewInsertEventArgs al controlador de eventos, que le permite determinar el valor de un argumento de comando opcional enviado al control DetailsView e indicar que se debe cancelar la operación de inserción. Para determinar el valor del argumento de comando, utilice la propiedad CommandArgument. Para cancelar la operación de inserción, establezca la propiedad Cancel en true. También puede leer o modificar los valores de campo del nuevo registro utilizando la propiedad Values.

Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.

Para obtener una lista de los valores de propiedad iniciales de una instancia de la clase DetailsViewInsertEventArgs, vea el constructor DetailsViewInsertEventArgs.

En el ejemplo de código siguiente se muestra cómo utilizar el objeto DetailsViewInsertEventArgs pasado al controlador de eventos del evento ItemInserting para cancelar una operación de inserción.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomerDetailsView_ItemInserting(Object sender, 
    DetailsViewInsertEventArgs e)
  {
    // Use the Values property to retrieve the key field value.
    String keyValue = e.Values["CustomerID"].ToString();

    // Insert the record only if the key field is four characters
    // long; otherwise, cancel the insert operation.
    if (keyValue.Length == 4)
    {
      // Change the key field value to upper case before inserting 
      // the record in the data source.
      e.Values["CustomerID"] = keyValue.ToUpper();

      MessageLabel.Text = "";
    }
    else
    {
      MessageLabel.Text = "The key field must have four digits.";
      e.Cancel = true;
    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewInsertEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewInsertEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          oniteminserting="CustomerDetailsView_ItemInserting" 
          runat="server">
               
          <fieldheaderstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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"
          selectcommand="Select [CustomerID], [CompanyName], [Address], 
            [City], [PostalCode], [Country] From [Customers]"
          insertcommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], 
            [Country]) VALUES (@CustomerID, @CompanyName, @Address, 
            @City, @PostalCode, @Country)"
          connectionstring=
          "<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>


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

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.DetailsViewInsertEventArgs

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: