Cette documentation est archivée et n’est pas conservée.

DetailsViewDeletedEventArgs, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Fournit des données pour l'événement ItemDeleted.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class DetailsViewDeletedEventArgs : EventArgs
public class DetailsViewDeletedEventArgs extends EventArgs
public class DetailsViewDeletedEventArgs extends EventArgs

Le contrôle DetailsView déclenche l'événement ItemDeleted suite à un clic sur le bouton Supprimer (bouton dont la propriété CommandName a la valeur "Delete"), mais seulement après que le contrôle DetailsView a supprimé l'enregistrement. Cela vous permet de fournir un gestionnaire d'événements qui exécute une routine personnalisée, par exemple la vérification des résultats d'une opération de suppression, chaque fois que cet événement se produit.

Un objet DetailsViewDeletedEventArgs est passé au gestionnaire d'événements qui vous permet de déterminer le nombre d'enregistrements affectés et toutes les exceptions éventuellement levées. Pour déterminer le nombre d'enregistrements affectés par l'opération de suppression, utilisez la propriété AffectedRows. Pour déterminer si des exceptions se sont produites, utilisez la propriété Exception. Vous pouvez également indiquer si l'exception a été gérée dans le gestionnaire d'événements en définissant la propriété ExceptionHandled. Si vous souhaitez accéder aux paires nom/valeur des champs clés et des champs ne correspondant pas à une clé de l'enregistrement supprimé, utilisez respectivement les propriétés Keys et Values.

Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

Pour obtenir la liste des valeurs de propriété initiales d'une instance de la classe DetailsViewDeletedEventArgs, consultez le constructeur DetailsViewDeletedEventArgs.

L'exemple suivant montre comment utiliser l'objet DetailsViewDeletedEventArgs passé au gestionnaire d'événements pour l'événement ItemDeleted afin de déterminer si une exception s'est produite pendant une opération de suppression.


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

<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>
  <body>
    <form 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>


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.EventArgs
    System.Web.UI.WebControls.DetailsViewDeletedEventArgs

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: