(0) exportieren Drucken
Alle erweitern

GridViewDeleteEventArgs-Klasse

Stellt Daten für das RowDeleting-Ereignis bereit.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public class GridViewDeleteEventArgs : CancelEventArgs
public class GridViewDeleteEventArgs extends CancelEventArgs
public class GridViewDeleteEventArgs extends CancelEventArgs
Nicht zutreffend.

Das GridView-Steuerelement löst das RowDeleting-Ereignis aus, wenn auf eine Schaltfläche Löschen geklickt wird (eine Schaltfläche, deren CommandName-Eigenschaft auf "Delete" festgelegt wurde). Dabei wird das Ereignis ausgelöst, bevor das GridView-Steuerelement den Datensatz löscht. Dadurch können Sie eine Ereignisbehandlungsmethode bereitstellen, die bei jedem Auftreten dieses Ereignisses eine benutzerdefinierte Routine durchführt, beispielsweise den Abbruch des Löschvorgangs.

Ein GridViewDeleteEventArgs-Objekt wird an die Ereignisbehandlungsmethode weitergegeben. So können Sie den Index der zu löschenden Zeile bestimmen und angeben, dass der Löschvorgang abgebrochen werden soll. Legen Sie die Cancel-Eigenschaft des GridViewDeleteEventArgs-Objekts auf true fest, um den Löschvorgang abzubrechen. Falls erforderlich, können Sie auch die Keys- und die Values-Auflistung bearbeiten, bevor die Werte an die Datenquelle übergeben werden.

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von GridViewDeleteEventArgs finden Sie unter GridViewDeleteEventArgs-Konstruktor.

Das folgende Beispiel veranschaulicht die Verwendung des an die Ereignisbehandlungsmethode übergebenen GridViewDeleteEventArgs-Objekts zum Abbrechen des Löschvorgangs, wenn der Benutzer versucht, den letzten Datensatz aus einem GridView-Steuerelement zu entfernen.


<%@ 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 CustomersGridView_RowDeleting(Object sender, GridViewDeleteEventArgs e)
  {
    
    // Cancel the delete operation if the user attempts to remove
    // the last record from the GridView control.
    if (CustomersGridView.Rows.Count <= 1)
    {
        
      e.Cancel = true;
      Message.Text = "You must keep at least one record.";
            
    }
    
  }  

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView RowDeleting Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView RowDeleting 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"
        onrowdeleting="CustomersGridView_RowDeleting"  
        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>



System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.GridViewDeleteEventArgs

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework

Unterstützt in: 3.0, 2.0
Anzeigen:
© 2014 Microsoft