DetailsViewDeletedEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Daten für das ItemDeleted-Ereignis bereit.
public ref class DetailsViewDeletedEventArgs : EventArgspublic class DetailsViewDeletedEventArgs : EventArgstype DetailsViewDeletedEventArgs = class
inherit EventArgsPublic Class DetailsViewDeletedEventArgs
Inherits EventArgs- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie das DetailsViewDeletedEventArgs an den Ereignishandler übergebene Objekt für das ItemDeleted Ereignis verwendet wird, um zu bestimmen, ob während eines Löschvorgangs eine Ausnahme aufgetreten ist.
<%@ 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 StoresDetailView_ItemDeleted(Object sender,
DetailsViewDeletedEventArgs 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 the numbers of
// rows affected by the delete operation.
if (e.AffectedRows == 1)
{
MessageLabel.Text = e.AffectedRows.ToString()
+ " record deleted successfully.";
}
else
{
MessageLabel.Text = e.AffectedRows.ToString()
+ " records deleted successfully.";
}
}
else
{
// Insert the code to handle the exception.
MessageLabel.Text = e.Exception.Message;
// Use the ExceptionHandled property to indicate that the
// exception is already handled.
e.ExceptionHandled = true;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsViewDeletedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsViewDeletedEventArgs Example</h3>
<asp:detailsview id="CustomerDetailsView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogeneratedeletebutton="true"
autogeneraterows="true"
allowpaging="true"
onitemdeleted="StoresDetailView_ItemDeleted"
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" AutoEventWireup="False" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub StoresDetailView_ItemDeleted(ByVal sender As Object, _
ByVal e As DetailsViewDeletedEventArgs) _
Handles CustomerDetailsView.ItemDeleted
' Use the Exception property to determine whether an exception
' occurred during the delete operation.
If e.Exception Is Nothing Then
' Use the AffectedRows property to determine the numbers of
' rows affected by the delete operation.
If e.AffectedRows = 1 Then
MessageLabel.Text = e.AffectedRows.ToString() _
& " record deleted successfully."
Else
MessageLabel.Text = e.AffectedRows.ToString() _
& " records deleted successfully."
End If
Else
' Insert the code to handle the exception.
MessageLabel.Text = e.Exception.Message
' Use the ExceptionHandled property to indicate that the
' exception is already handled.
e.ExceptionHandled = True
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsViewDeletedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DetailsViewDeletedEventArgs Example</h3>
<asp:detailsview id="CustomerDetailsView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogeneratedeletebutton="true"
autogeneraterows="true"
allowpaging="true"
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 löst das ItemDeleted -Ereignis aus, wenn auf eine Schaltfläche "Löschen" (eine Schaltfläche mit der auf "Löschen" gesetzten CommandName Eigenschaft) innerhalb des Steuerelements geklickt wird, aber nachdem das DetailsView Steuerelement den Datensatz gelöscht hat. Dadurch können Sie einen Ereignishandler bereitstellen, der eine benutzerdefinierte Routine ausführt, z. B. das Überprüfen der Ergebnisse eines Löschvorgangs, wenn dieses Ereignis auftritt.
Ein DetailsViewDeletedEventArgs -Objekt wird an den Ereignishandler übergeben, mit dem Sie die Anzahl der betroffenen Datensätze und ggf. aufgetretene Ausnahmen ermitteln können. Verwenden Sie AffectedRows die -Eigenschaft, um die Anzahl der Datensätze zu bestimmen, die vom Löschvorgang betroffen sind. Verwenden Sie die Exception -Eigenschaft, um zu bestimmen, ob Ausnahmen aufgetreten sind. Sie können auch angeben, ob die Ausnahme im Ereignishandler behandelt wurde, indem Sie die ExceptionHandled -Eigenschaft festlegen. Wenn Sie die Name-Wert-Paare der Schlüsselfelder und nichtschlüsselfelder des gelöschten Datensatzes zugreifen möchten, verwenden Sie die Keys und Values Eigenschaften bzw.
Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz der DetailsViewDeletedEventArgs-Klasse finden Sie im DetailsViewDeletedEventArgs-Konstruktor.
Konstruktoren
| DetailsViewDeletedEventArgs(Int32, Exception) |
Initialisiert eine neue Instanz der DetailsViewDeletedEventArgs-Klasse. |
Eigenschaften
| AffectedRows |
Ruft die Anzahl der vom Löschvorgang betroffenen Zeilen ab. |
| Exception |
Ruft die Ausnahme (sofern vorhanden) ab, die während des Löschvorgangs ausgelöst wurde. |
| ExceptionHandled |
Ruft einen Wert ab, der angibt, ob während der Behandlung des Löschvorgangs im Ereignishandler eine Ausnahme ausgelöst wurde, oder legt diesen Wert fest. |
| 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. |
| Values |
Ruft ein Wörterbuch mit Name-Wert-Paaren der Nicht-Schlüsselfelder für das zu löschende Element ab. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
