GridView.RowDeleted Evento
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.
Ocorre quando o botão Delete de uma linha é clicado, mas depois de o controlo GridView eliminar a linha.
public:
event System::Web::UI::WebControls::GridViewDeletedEventHandler ^ RowDeleted;public event System.Web.UI.WebControls.GridViewDeletedEventHandler RowDeleted;member this.RowDeleted : System.Web.UI.WebControls.GridViewDeletedEventHandler Public Custom Event RowDeleted As GridViewDeletedEventHandler Tipo de Evento
Exemplos
O exemplo seguinte demonstra como usar o RowDeleted evento para verificar o resultado da operação de eliminação. É exibida uma mensagem para indicar ao utilizador se a operação teve sucesso.
<%@ 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)
{
// Display whether the delete operation succeeded.
if(e.Exception == null)
{
Message.Text = "Row deleted successfully.";
}
else
{
Message.Text = "An error occurred while attempting to delete the row.";
e.ExceptionHandled = true;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView RowDeleted Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView RowDeleted Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<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(sender As Object, e As GridViewDeletedEventArgs)
' Display whether the delete operation succeeded.
If e.Exception Is Nothing Then
Message.Text = "Row deleted successfully."
Else
Message.Text = "An error occurred while attempting to delete the row."
e.ExceptionHandled = True
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView RowDeleted Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView RowDeleted Example</h3>
<asp:label id="Message"
forecolor="Red"
runat="server"/>
<br/>
<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 RowDeleted evento é ativado quando o botão Delete de uma linha é clicado, mas depois de o GridView controlo apagar a linha. Isto permite-lhe fornecer um método de gestão de eventos que executa uma rotina personalizada, como verificar os resultados da operação de eliminação, sempre que este evento ocorre.
Um GridViewDeletedEventArgs objeto é passado para o método de gestão de eventos, o que permite determinar o número de linhas afetadas e quaisquer exceções que possam ter ocorrido. Também pode indicar se a exceção foi tratada no método de gestão de eventos, definindo a ExceptionHandled propriedade do GridViewDeletedEventArgs objeto.
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.