DetailsViewDeletedEventArgs Clase

Definición

Proporciona datos para el evento ItemDeleted.Provides data for the ItemDeleted event.

public ref class DetailsViewDeletedEventArgs : EventArgs
public class DetailsViewDeletedEventArgs : EventArgs
type DetailsViewDeletedEventArgs = class
    inherit EventArgs
Public Class DetailsViewDeletedEventArgs
Inherits EventArgs
Herencia
DetailsViewDeletedEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el DetailsViewDeletedEventArgs objeto pasado al controlador de eventos para el ItemDeleted evento con el fin de determinar si se produjo una excepción durante una operación de eliminación.The following code example demonstrates how to use the DetailsViewDeletedEventArgs object passed to the event handler for the ItemDeleted event to determine whether an exception occurred during a delete operation.


<%@ 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 StoresDetailView_ItemDeleted(Object sender, 
    DetailsViewDeletedEventArgs e)
  {
    // Use the Exception property to determine whether an exception
    // occurred during the delete operation.
    if (e.Exception == null)
    {
      // Use the AffectedRows property to determine the numbers of
      // rows affected by the delete operation.
      if (e.AffectedRows == 1)
      {
        MessageLabel.Text = e.AffectedRows.ToString() 
          + " record deleted successfully.";
      }
      else
      {
        MessageLabel.Text = e.AffectedRows.ToString() 
          + " records deleted 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;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewDeletedEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewDeletedEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          onitemdeleted="StoresDetailView_ItemDeleted" 
          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]"
          deletecommand="Delete [Customers] 
            Where [CustomerID]=@CustomerID"
          connectionstring=
            "<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>


<%@ Page language="VB" AutoEventWireup="False" %>

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

  Sub StoresDetailView_ItemDeleted(ByVal sender As Object, _
    ByVal e As DetailsViewDeletedEventArgs) _
    Handles CustomerDetailsView.ItemDeleted
  
    ' Use the Exception property to determine whether an exception
    ' occurred during the delete operation.
    If e.Exception Is Nothing Then
    
      ' Use the AffectedRows property to determine the numbers of
      ' rows affected by the delete operation.
      If e.AffectedRows = 1 Then
      
        MessageLabel.Text = e.AffectedRows.ToString() _
          & " record deleted successfully."
      
      Else
              
        MessageLabel.Text = e.AffectedRows.ToString() _
          & " records deleted successfully."
      
      End If
    
    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
    
    End If
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewDeletedEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewDeletedEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          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]"
          deletecommand="Delete [Customers] 
            Where [CustomerID]=@CustomerID"
          connectionstring=
            "<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Comentarios

El DetailsView control provoca el ItemDeleted evento cuando se hace clic en un botón Eliminar (un botón con su CommandName propiedad establecida en "eliminar") dentro del control, pero después de que el DetailsView control elimine el registro.The DetailsView control raises the ItemDeleted event when a Delete button (a button with its CommandName property set to "Delete") within the control is clicked, but after the DetailsView control deletes the record. Esto le permite proporcionar un controlador de eventos que realiza una rutina personalizada, como comprobar los resultados de una operación de eliminación, siempre que se produzca este evento.This allows you to provide an event handler that performs a custom routine, such as checking the results of a delete operation, whenever this event occurs.

Un DetailsViewDeletedEventArgs objeto se pasa al controlador de eventos, lo que permite determinar el número de registros afectados y cualquier excepción que se haya producido.A DetailsViewDeletedEventArgs object is passed to the event handler, which allows you to determine the number of records affected and any exceptions that might have occurred. Para determinar el número de registros afectados por la operación de eliminación, use la AffectedRows propiedad.To determine the number of records affected by the delete operation, use the AffectedRows property. Utilice la Exception propiedad para determinar si se ha producido alguna excepción.Use the Exception property to determine whether any exceptions occurred. También puede indicar si la excepción se controló en el controlador de eventos estableciendo la ExceptionHandled propiedad.You can also indicate whether the exception was handled in the event handler by setting the ExceptionHandled property. Si desea tener acceso a los pares de nombre/valor de los campos de clave y los campos que no son de clave del registro eliminado, utilice las Keys Values propiedades y, respectivamente.If you want to access the name/value pairs of the key fields and non-key fields of the deleted record, use the Keys and Values properties, respectively.

Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.For more information about how to handle events, see Handling and Raising Events.

Para obtener una lista con los valores de propiedad iniciales de una instancia de la clase DetailsViewDeletedEventArgs, vea el constructor DetailsViewDeletedEventArgs.For a list of initial property values for an instance of the DetailsViewDeletedEventArgs class, see the DetailsViewDeletedEventArgs constructor.

Constructores

DetailsViewDeletedEventArgs(Int32, Exception)

Inicializa una nueva instancia de la clase DetailsViewDeletedEventArgs.Initializes a new instance of the DetailsViewDeletedEventArgs class.

Propiedades

AffectedRows

Obtiene el número de filas afectado por la operación de eliminación.Gets the number of rows affected by the delete operation.

Exception

Obtiene la excepción (si existe) que se provocó durante la operación de eliminación.Gets the exception (if any) that was raised during the delete operation.

ExceptionHandled

Obtiene o establece un valor que indica si el control de una excepción provocada durante la operación de eliminación se ha realizado en el controlador de eventos.Gets or sets a value indicating whether an exception that was raised during the delete operation was handled in the event handler.

Keys

Obtiene un diccionario ordenado de pares de nombre y valor de campo de claves que contiene los nombres y los valores de los campos de claves de los elementos eliminados.Gets an ordered dictionary of key field name/value pairs that contains the names and values of the key fields of the deleted items.

Values

Obtiene un diccionario de los pares de nombre/valor de campos no clave para el elemento que se va a eliminar.Gets a dictionary of the non-key field name/value pairs for the item to delete.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también