GridViewDeletedEventArgs Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece dados para o RowDeleted evento.
public ref class GridViewDeletedEventArgs : EventArgspublic class GridViewDeletedEventArgs : EventArgstype GridViewDeletedEventArgs = class
inherit EventArgsPublic Class GridViewDeletedEventArgs
Inherits EventArgs- Herança
Exemplos
O exemplo seguinte demonstra como usar o GridViewDeletedEventArgs objeto passado para o método de gestão de eventos para determinar RowDeleted se ocorreu uma exceção durante uma operação de eliminação.
<%@ 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_RowDeleted(Object sender, GridViewDeletedEventArgs 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)
{
Message.Text = "Record deleted successfully.";
}
else
{
Message.Text = "An error occurred during the delete operation.";
}
}
else
{
// Insert the code to handle the exception.
Message.Text = "An error occurred during the delete operation.";
// 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>GridViewDeletedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewDeletedEventArgs 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"
onrowdeleted="CustomersGridView_RowDeleted"
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>
<%@ 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 CustomersGridView_RowDeleted(ByVal sender As Object, ByVal e As GridViewDeletedEventArgs)
' 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 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 Then
Message.Text = "Record deleted successfully."
Else
Message.Text = "An error occurred during the delete operation."
End If
Else
' Insert the code to handle the exception.
Message.Text = "An error occurred during the delete operation."
' 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>GridViewDeletedEventArgs Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridViewDeletedEventArgs 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"
onrowdeleted="CustomersGridView_RowDeleted"
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>
Observações
O GridView controlo levanta o RowDeleted evento quando um botão Delete (um botão com CommandName a propriedade definida para "Eliminar") dentro do controlo é clicado, mas depois de o GridView controlo apagar o registo. Isto permite-lhe fornecer um método de gestão de eventos que executa uma rotina personalizada, como verificar os resultados de uma operação de eliminação, sempre que este evento ocorre.
Um objeto é passado para o método de gestão de eventos, que permite determinar o número de registos GridViewDeletedEventArgs afetados e quaisquer exceções que possam ter ocorrido. Para determinar o número de registos afetados pela operação de eliminação, use a AffectedRows propriedade. Use a Exception propriedade para determinar se ocorreram exceções. Também pode indicar se a exceção foi tratada no método de gestão de eventos, definindo a ExceptionHandled propriedade.
Note
Se ocorrer uma exceção durante a operação de eliminação e a ExceptionHandled propriedade for definida para false, o GridView controlo relança a exceção.
Se quiseres aceder aos pares nome/valor dos campos-chave e dos campos não-chave do registo eliminado, usa as Keys propriedades e Values respetivamente.
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.
Construtores
| Name | Description |
|---|---|
| GridViewDeletedEventArgs(Int32, Exception) |
Inicializa uma nova instância da GridViewDeletedEventArgs classe. |
Propriedades
| Name | Description |
|---|---|
| AffectedRows |
Obtém o número de linhas afetadas pela operação de eliminação. |
| Exception |
Recebe a exceção (se houver) que foi levantada durante a operação de eliminação. |
| ExceptionHandled |
Recebe ou define um valor que indica se uma exceção levantada durante a operação de eliminação foi tratada no gestor de eventos. |
| Keys |
Obtém um dicionário ordenado dos pares de nome de campo/valor de chave para o registo eliminado. |
| Values |
Obtém um dicionário dos pares de nome de campo/valor não-chave para o registo eliminado. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |