DetailsViewDeleteEventArgs DetailsViewDeleteEventArgs DetailsViewDeleteEventArgs DetailsViewDeleteEventArgs Class

Definition

Stellt Daten für das ItemDeleting-Ereignis bereit.Provides data for the ItemDeleting event.

public ref class DetailsViewDeleteEventArgs : System::ComponentModel::CancelEventArgs
public class DetailsViewDeleteEventArgs : System.ComponentModel.CancelEventArgs
type DetailsViewDeleteEventArgs = class
    inherit CancelEventArgs
Public Class DetailsViewDeleteEventArgs
Inherits CancelEventArgs
Vererbung
DetailsViewDeleteEventArgsDetailsViewDeleteEventArgsDetailsViewDeleteEventArgsDetailsViewDeleteEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das DetailsViewDeleteEventArgs -Objekt verwendet wird, das an den ItemDeleting -Ereignishandler für das-Ereignis geleitet wird, um einen Löschvorgang abzubrechenThe following code example demonstrates how to use the DetailsViewDeleteEventArgs object passed to the event handler for the ItemDeleting event to cancel a delete operation.


<%@ 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>

Hinweise

Das DetailsView -Steuerelement ItemDeleting löst das-Ereignis aus, DetailsView wenn auf eine Lösch CommandName Schaltfläche (eine Schaltfläche, deren-Eigenschaft auf "Delete" festgelegt ist) im-Steuerelement geklickt wirdThe DetailsView control raises the ItemDeleting event when a Delete button (a button with its CommandName property set to "Delete") within the control is clicked, but before the DetailsView control deletes the record. Dies ermöglicht Ihnen die Bereitstellung eines Ereignis Handlers, der eine benutzerdefinierte Routine ausführt, z. b. das Überprüfen eines Datensatzes vor dem Löschen, wenn dieses Ereignis auftritt.This allows you to provide an event handler that performs a custom routine, such as verifying a record before deleting it, whenever this event occurs.

Ein DetailsViewDeletedEventArgs -Objekt wird an den-Ereignishandler übermittelt, mit dem Sie den Index des gelöschten Datensatzes ermitteln und angeben können, dass der Löschvorgang abgebrochen werden soll.A DetailsViewDeletedEventArgs object is passed to the event handler, which allows you to determine the index of the record being deleted and to indicate that the delete operation should be canceled. Um den Index eines Datensatzes zu bestimmen, verwenden RowIndex Sie die-Eigenschaft.To determine the index of a record, use the RowIndex property. Um den Löschvorgang abzubrechen, legen Cancel Sie die true-Eigenschaft auf fest.To cancel the delete operation, set the Cancel property to true. Sie können auch die Schlüsselfelder und nichtschlüsselfelder zugreifen, mithilfe der Keys und Values Eigenschaften bzw.You can also access the key fields and non-key fields by using the Keys and Values properties, respectively. Diese Werte sind nützlich, wenn Sie den Datensatz vor dem Löschen überprüfen möchten.These values are useful if you want to verify the record before deleting it.

Hinweis

Es ist möglich, die Schlüssel Feldwerte in der Keys -Eigenschaft zu ändern.It is possible to modify the key field values in the Keys property. Wenn Sie diese Werte ändern, wird der Datensatz gelöscht, der den neuen Schlüssel Feldwerten entspricht.If you change these values, the record that corresponds to the new key field values will be deleted.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about how to handle events, see Handling and Raising Events.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz der DetailsViewDeleteEventArgs -Klasse finden Sie DetailsViewDeleteEventArgs unter dem-Konstruktor.For a list of initial property values for an instance of DetailsViewDeleteEventArgs class, see the DetailsViewDeleteEventArgs constructor.

Konstruktoren

DetailsViewDeleteEventArgs(Int32) DetailsViewDeleteEventArgs(Int32) DetailsViewDeleteEventArgs(Int32) DetailsViewDeleteEventArgs(Int32)

Initialisiert eine neue Instanz der DetailsViewDeleteEventArgs-Klasse.Initializes a new instance of the DetailsViewDeleteEventArgs class.

Eigenschaften

Cancel Cancel Cancel Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
Keys Keys Keys Keys

Ruft ein sortiertes Wörterbuch mit Name-Wert-Paaren der Schlüsselfelder ab, das die Namen und die Werte der Schlüsselfelder der gelöschten Elemente enthält.Gets an ordered dictionary of key field name/value pairs that contains the names and values of the key fields of the deleted items.

RowIndex RowIndex RowIndex RowIndex

Ruft den Index der zu löschenden Zeile ab.Gets the index of the row being deleted.

Values Values Values Values

Ruft ein Wörterbuch mit Name-Wert-Paaren der Nicht-Schlüsselfelder für das zu löschende Element ab.Gets a dictionary of the non-key field name/value pairs for the item to delete.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch