DetailsViewDeleteEventArgs Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public ref class DetailsViewDeleteEventArgs : System::ComponentModel::CancelEventArgs

public class DetailsViewDeleteEventArgs : System.ComponentModel.CancelEventArgs

type DetailsViewDeleteEventArgs = class
    inherit CancelEventArgs

Public Class DetailsViewDeleteEventArgs
Inherits CancelEventArgs

Héritage: Object

EventArgs

CancelEventArgs
DetailsViewDeleteEventArgs

Exemples

L’exemple de code suivant montre comment utiliser l’objet DetailsViewDeleteEventArgs passé au gestionnaire d’événements pour l’événement ItemDeleting afin d’annuler une opération de suppression.


<%@ 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_ItemDeleting(Object sender, 
    DetailsViewDeleteEventArgs e)
  {

    // Get customer ID and name from the Keys and Values
    // properties.
    String keyValue = e.Keys["CustomerID"].ToString();
    String customerName = e.Values["CompanyName"].ToString();

    // Cancel the delete operation if the user attempts to 
    // delete protected record. In this example, records
    // with a customer ID that starts with with "A" cannot
    // be deleted.
    if (keyValue.StartsWith("A"))
    {
      e.Cancel = true;
      MessageLabel.Text = "You cannot delete " +
        customerName + ". This customer is protected.";
    }
    else
    {
      MessageLabel.Text = "Row " + e.RowIndex.ToString() + 
        " deleted.";
    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewDeleteEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewDeleteEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          onitemdeleting="CustomerDetailsView_ItemDeleting" 
          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" %>

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

  Sub CustomerDetailsView_ItemDeleting(ByVal sender As Object, _
    ByVal e As DetailsViewDeleteEventArgs)

    ' Get customer ID and name from the Keys and Values
    ' properties.
    Dim keyValue As String = e.Keys("CustomerID").ToString()
    Dim customerName As String = e.Values("CompanyName").ToString()

    ' Cancel the delete operation if the user attempts to 
    ' delete protected record. In this example, records
    ' with a customer ID that starts with with "A" cannot
    ' be deleted.
    If keyValue.StartsWith("A") Then

      e.Cancel = True
      MessageLabel.Text = "You cannot delete " & _
        customerName & ". This customer is protected."
    
    Else
    
      MessageLabel.Text = "Row " & e.RowIndex.ToString() & _
        " deleted."
    
    End If
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewDeleteEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewDeleteEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          onitemdeleting="CustomerDetailsView_ItemDeleting" 
          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>

Remarques

Le DetailsView contrôle déclenche l’événement ItemDeleting lorsqu’un clic sur un bouton Supprimer (un bouton dont CommandName la propriété est définie sur « Supprimer ») dans le contrôle est cliqué, mais avant que le DetailsView contrôle ne supprime l’enregistrement. Cela vous permet de fournir un gestionnaire d’événements qui effectue une routine personnalisée, telle que la vérification d’un enregistrement avant de le supprimer, chaque fois que cet événement se produit.

Un DetailsViewDeletedEventArgs objet est passé au gestionnaire d’événements, ce qui vous permet de déterminer l’index de l’enregistrement en cours de suppression et d’indiquer que l’opération de suppression doit être annulée. Pour déterminer l’index d’un enregistrement, utilisez la RowIndex propriété . Pour annuler l’opération de suppression, définissez la propriété sur Canceltrue. Vous pouvez également accéder aux champs de clé et aux champs non clés à l’aide des Keys propriétés et Values , respectivement. Ces valeurs sont utiles si vous souhaitez vérifier l’enregistrement avant de le supprimer.

Notes

Il est possible de modifier les valeurs de champ de clé dans la Keys propriété . Si vous modifiez ces valeurs, l’enregistrement qui correspond aux nouvelles valeurs de champ de clé est supprimé.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.

Pour obtenir la liste des valeurs de propriété initiales d’un instance de DetailsViewDeleteEventArgs classe, consultez le DetailsViewDeleteEventArgs constructeur .

Constructeurs

DetailsViewDeleteEventArgs(Int32)

Initialise une nouvelle instance de la classe DetailsViewDeleteEventArgs.

Propriétés

Cancel	Obtient ou définit une valeur indiquant si l'événement doit être annulé. (Hérité de CancelEventArgs)
Keys	Obtient un dictionnaire trié de paires nom/valeur de champ clé qui contient les noms et les valeurs des champs clés des éléments supprimés.
RowIndex	Obtient l'index de la ligne en cours de suppression.
Values	Obtient un dictionnaire des paires nom/valeur de champs ne correspondant pas à une clé pour l'élément à supprimer.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à