DetailsViewDeletedEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce i dati per l'evento ItemDeleted.
public ref class DetailsViewDeletedEventArgs : EventArgspublic class DetailsViewDeletedEventArgs : EventArgstype DetailsViewDeletedEventArgs = class
inherit EventArgsPublic Class DetailsViewDeletedEventArgs
Inherits EventArgs- Ereditarietà
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare l'oggetto DetailsViewDeletedEventArgs passato al gestore eventi per l'evento per determinare se si è verificata un'eccezione ItemDeleted durante un'operazione di eliminazione.
<%@ 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>
Commenti
Il DetailsView controllo genera l'evento ItemDeleted quando si fa clic su un pulsante Elimina (un pulsante con la relativa CommandName proprietà impostata su "Elimina") all'interno del controllo, ma dopo che il DetailsView controllo elimina il record. In questo modo è possibile fornire un gestore eventi che esegue una routine personalizzata, ad esempio il controllo dei risultati di un'operazione di eliminazione, ogni volta che si verifica questo evento.
Un DetailsViewDeletedEventArgs oggetto viene passato al gestore eventi, che consente di determinare il numero di record interessati e le eventuali eccezioni che potrebbero essersi verificate. Per determinare il numero di record interessati dall'operazione di eliminazione, utilizzare la AffectedRows proprietà . Utilizzare la Exception proprietà per determinare se si sono verificate eccezioni. È anche possibile indicare se l'eccezione è stata gestita nel gestore eventi impostando la ExceptionHandled proprietà . Se si desidera accedere alle coppie nome/valore dei campi chiave e dei campi non chiave del record eliminato, usare rispettivamente le Keys proprietà e Values .
Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.
Per un elenco dei valori iniziali delle proprietà di un'istanza della classe DetailsViewDeletedEventArgs, vedere il costruttore DetailsViewDeletedEventArgs.
Costruttori
| DetailsViewDeletedEventArgs(Int32, Exception) |
Inizializza una nuova istanza della classe DetailsViewDeletedEventArgs. |
Proprietà
| AffectedRows |
Ottiene il numero di righe interessate dall'operazione di eliminazione. |
| Exception |
Ottiene l'eventuale eccezione generata durante l'operazione di eliminazione. |
| ExceptionHandled |
Ottiene o imposta un valore che indica se un'eccezione generata durante l'operazione di eliminazione è stata gestita nel gestore eventi. |
| Keys |
Ottiene un dizionario ordinato delle coppie nome/valore dei campi chiave che contiene i nomi e i valori dei campi chiave degli elementi eliminati. |
| Values |
Ottiene un dizionario delle coppie nome/valore dei campi non chiave dell'elemento da eliminare. |
Metodi
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
