Exporter (0) Imprimer
Développer tout

GridViewDeletedEventArgs, classe

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

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

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

public class GridViewDeletedEventArgs : EventArgs
public class GridViewDeletedEventArgs extends EventArgs
public class GridViewDeletedEventArgs extends EventArgs

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

Un objet GridViewDeletedEventArgs est passé à la méthode de gestion d'événements qui vous permet de déterminer le nombre d'enregistrements affectés et toutes les exceptions éventuellement rencontrées. Pour déterminer le nombre d'enregistrements affectés par l'opération de suppression, utilisez la propriété AffectedRows. Utilisez la propriété Exception pour déterminer si des exceptions se sont produites. Vous pouvez également indiquer si l'exception a été gérée dans la méthode de gestion d'événements en définissant la propriété ExceptionHandled.

RemarqueRemarque

Si une exception se produit pendant l'opération de suppression et la propriété ExceptionHandled a la valeur false, le contrôle GridView lève de nouveau l'exception.

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.

L'exemple suivant montre comment utiliser l'objet GridViewDeletedEventArgs passé à la méthode de gestion d'événements pour que l'événement RowDeleted détermine si une exception s'est produite pendant une opération de suppression.


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

<script runat="server">

  void CustomersGridView_RowDeleted(Object sender, GridViewDeletedEventArgs 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 whether the
      // record was deleted. Sometimes an error might occur that 
      // does not raise an exception, but prevents the delete
      // operation from completing.
      if (e.AffectedRows == 1)
      {
        Message.Text = "Record deleted successfully.";
      }
      else
      {
        Message.Text = "An error occurred during the delete operation.";
      }
    }
    else
    {
      // Insert the code to handle the exception.
      Message.Text = "An error occurred during the delete operation.";

      // Use the ExceptionHandled property to indicate that the 
      // exception is already handled.
      e.ExceptionHandled = true;
    }
    
  }
    
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridViewDeletedEventArgs Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"          
        runat="server"/>
                
      <br/>
            
      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogeneratedeletebutton="true"
        datakeynames="CustomerID"
        onrowdeleted="CustomersGridView_RowDeleted"  
        runat="server">
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
      
    </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.GridViewDeletedEventArgs

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft