DetailsViewInsertedEventArgs (Clase)
Ensamblado: System.Web (en system.web.dll)
El control DetailsView provoca el evento ItemInserted cuando se hace clic en un botón de inserción (botón con su propiedad CommandName establecida en "Insert") dentro del control, pero después de que el control DetailsView inserte el registro. Esto permite proporcionar un controlador de eventos que realiza una rutina personalizada, como comprobar los resultados de una operación de inserción, cada vez que se produce este evento.
Un objeto DetailsViewInsertedEventArgs se pasa al controlador de eventos, lo que permite determinar el número de registros afectados y las excepciones que puedan haberse producido. Para determinar el número de registros afectados por la operación de inserción, utilice la propiedad AffectedRows. Utilice la propiedad Exception para determinar si se han producido excepciones. También puede indicar si la excepción se controló en el controlador de eventos estableciendo la propiedad ExceptionHandled. Si necesita tener acceso a los valores del registro insertado, utilice la propiedad Values.
De manera predeterminada, el control DetailsView vuelve al modo especificado por la propiedad DefaultMode después de una operación de inserción. Para mantener el control DetailsView en modo de inserción, establezca la propiedad KeepInInsertMode en true.
Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.
Para obtener una lista con los valores de propiedad iniciales de una instancia de la clase DetailsViewDeletedEventArgs, vea el constructor DetailsViewDeletedEventArgs.
En el ejemplo de código siguiente se muestra cómo utilizar el objeto DetailsViewInsertedEventArgs que se pasa al controlador de eventos para que el evento ItemInserted determine si se generó una excepción durante 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_ItemInserted(Object sender, DetailsViewInsertedEventArgs e) { // Use the Exception property to determine whether an exception // occurred during the insert operation. if (e.Exception == null && e.AffectedRows == 1) { // Use the Values property to get the value entered by // the user for the CompanyName field. String name = e.Values["CompanyName"].ToString(); // Display a confirmation message. MessageLabel.Text = name + " added successfully. "; } else { // Insert the code to handle the exception. MessageLabel.Text = e.Exception.Message; // Use the ExceptionHandled property to indicate that the // exception is already handled. e.ExceptionHandled = true; // When an exception occurs, keep the DetailsView // control in insert mode. e.KeepInInsertMode = true; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>DetailsViewInsertedEventArgs Example</title> </head> <body> <form id="form1" runat="server"> <h3>DetailsViewInsertedEventArgs Example</h3> <asp:detailsview id="CustomerDetailsView" datasourceid="DetailsViewSource" datakeynames="CustomerID" autogenerateinsertbutton="true" autogeneraterows="true" allowpaging="true" oniteminserted="CustomerDetailsView_ItemInserted" 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
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.