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

FormViewDeletedEventArgs.AffectedRows, propriété

Mise à jour : novembre 2007

Obtient le nombre de lignes affectées par l'opération de suppression.

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

public int AffectedRows { get; }
/** @property */
public int get_AffectedRows()

public function get AffectedRows () : int

Valeur de propriété

Type : System.Int32

Nombre de lignes affectées par l'opération de suppression.

Pour déterminer le nombre d'enregistrements affectés par l'opération de suppression, utilisez la propriété AffectedRows. Cette propriété est généralement utilisée pour vérifier que le nombre d'enregistrements supprimés est correct dans les situations suivantes :

  • Vérifiez qu'un seul enregistrement a été supprimé. Parfois, une instruction Delete mal écrite peut entraîner la suppression de plusieurs enregistrements.

  • Vérifiez qu'un enregistrement a bien été supprimé lorsqu'une erreur se produit pendant l'opération de suppression qui ne provoque pas la levée d'une exception.

  • Vérifiez qu'un enregistrement a bien été supprimé lorsqu'un contrôle de source de données qui prend en charge la détection de conflit (accès concurrentiel optimiste), par exemple les contrôles SqlDataSource et ObjectDataSource, a la valeur d'énumération ConflictOptions.CompareAllValues affectée à sa propriété ConflictDetection. Sous ce paramètre, un enregistrement qui a été modifié par un autre utilisateur ne peut pas être supprimé en même temps.

L'exemple suivant montre comment utiliser la propriété AffectedRows pour vérifier qu'un enregistrement a été supprimé pendant l'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 EmployeeFormView_ItemDeleted(Object sender, FormViewDeletedEventArgs 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)
      {
        MessageLabel.Text = "Record deleted successfully.";
      }
      else
      {
        MessageLabel.Text = "An error occurred during the delete operation.";
      }
    }
    else
    {
      // Insert the code to handle the exception.
      MessageLabel.Text = e.Exception.Message;

      // Use the ExceptionHandled property to indicate that the 
      // exception has already been handled.
      e.ExceptionHandled = true;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>FormViewDeletedEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>FormViewDeletedEventArgs Example</h3>

      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        onitemdeleted="EmployeeFormView_ItemDeleted"  
        runat="server">

        <itemtemplate>

          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %>&nbsp;<%# Eval("LastName") %></h3>      
                <%# Eval("Title") %>        
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:button id="DeleteButton"
                  text="Delete Record"
                  commandname="Delete"
                  runat="server" />
              </td>
            </tr>
          </table>

        </itemtemplate>         

      </asp:formview>

      <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="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        deletecommand="Delete [Employees] Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>

    </form>
  </body>
</html>



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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: