Exporter (0) Imprimer
Développer tout

GridViewCancelEditEventArgs, classe

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

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

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

public class GridViewCancelEditEventArgs : CancelEventArgs
public class GridViewCancelEditEventArgs extends CancelEventArgs
public class GridViewCancelEditEventArgs extends CancelEventArgs

Le contrôle GridView déclenche l'événement RowCancelingEdit lorsqu'un clic est effectué sur le bouton Annuler (bouton dont la propriété CommandName a la valeur « Cancel »), mais avant de quitter le mode édition. Cela vous permet de fournir une méthode de gestion d'événements qui exécute une routine personnalisée, par exemple l'arrêt de l'opération d'annulation si elle risque de placer la ligne dans un état indésirable, chaque fois que cet événement se produit.

Un objet GridViewCancelEditEventArgs est passé à la méthode de gestion d'événements, ce qui vous permet de déterminer l'index de la ligne contenant le bouton Annuler qui a déclenché l'événement et d'indiquer que l'opération d'annulation doit être arrêtée. Pour arrêter l'opération d'annulation, affectez true à la propriété Cancel.

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

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

L'exemple suivant montre comment utiliser l'objet GridViewCancelEditEventArgs passé à la méthode de gestion d'événements pour déterminer l'index de la ligne contenant le bouton Annuler sur lequel l'utilisateur a cliqué.


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

<script runat="server">

  void CustomersGridView_RowCancelingEdit(Object sender, GridViewCancelEditEventArgs e)
  {
    
    // Retrieve the row that raised the event from the Rows
    // collection of the GridView control.
    GridViewRow row = CustomersGridView.Rows[e.RowIndex];
    
    // The update operation was canceled. Display the 
    // primary key of the row. In this example, the primary
    // key is displayed in the second column of the GridView
    // control. To access the text of the column, use the Cells
    // collection of the row.
    Message.Text = "Update for item " + row.Cells[1].Text + " Canceled."; 
    
  }

  void CustomersGridView_RowEditing(Object sender, GridViewEditEventArgs e)
  {

    // The GridView control is entering edit mode. Clear the message label.
    Message.Text = "";

  }
  
  void CustomersGridView_RowUpdated(Object sender, GridViewUpdatedEventArgs e)
  {

    // The update operation was successful. Clear the message label.
    Message.Text = "";

  }
    
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView RowCancelingEdit Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                
      <br/>
      
      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames attribute as read-only.   -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"
        onrowcancelingedit="CustomersGridView_RowCancelingEdit"
        onrowediting="CustomersGridView_RowEditing" 
        onrowupdated="CustomersGridView_RowUpdated"    
        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]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country 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.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.GridViewCancelEditEventArgs

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
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft