GridViewDeletedEventArgs Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje data pro událost RowDeleted.
public ref class GridViewDeletedEventArgs : EventArgspublic class GridViewDeletedEventArgs : EventArgstype GridViewDeletedEventArgs = class
inherit EventArgsPublic Class GridViewDeletedEventArgs
Inherits EventArgs- Dědičnost
Příklady
Následující příklad ukazuje, jak použít GridViewDeletedEventArgs objekt předaný do metody zpracování událostí pro RowDeleted událost k určení, zda došlo k výjimce během operace odstranění.
<%@ 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>
Poznámky
Ovládací GridView prvek vyvolá RowDeleted událost při kliknutí na tlačítko Odstranit (tlačítko s jeho CommandName vlastností nastavenou na "Odstranit") v rámci ovládacího prvku, ale poté GridView , co ovládací prvek odstraní záznam. To vám umožní poskytnout metodu zpracování událostí, která provádí vlastní rutinu, například kontrolu výsledků operace odstranění, kdykoli dojde k této události.
Objekt GridViewDeletedEventArgs se předá metodě zpracování událostí, která umožňuje určit počet ovlivněných záznamů a případné výjimky. Pokud chcete zjistit počet záznamů ovlivněných operací odstranění, použijte AffectedRows vlastnost . Exception Pomocí vlastnosti určete, jestli došlo k nějakým výjimkám. Nastavením vlastnosti můžete také určit, jestli byla výjimka zpracována v metodě zpracování událostí ExceptionHandled .
Poznámka
Pokud během operace odstranění dojde k výjimce ExceptionHandled a vlastnost je nastavena GridView na false, ovládací prvek znovu vyvolá výjimku.
Pokud chcete získat přístup k dvojici název/hodnota polí klíče a polí odstraněného záznamu Keys bez klíče, použijte vlastnosti a Values v uvedeném pořadí.
Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.
Konstruktory
| GridViewDeletedEventArgs(Int32, Exception) |
Inicializuje novou instanci GridViewDeletedEventArgs třídy. |
Vlastnosti
| AffectedRows |
Získá počet řádků ovlivněných operací odstranění. |
| Exception |
Získá výjimku (pokud existuje), která byla vyvolána během operace odstranění. |
| ExceptionHandled |
Získá nebo nastaví hodnotu určující, zda byla vyvolána výjimka, která byla vyvolána během operace odstranění byla zpracována v obslužné rutině události. |
| Keys |
Získá seřazený slovník párů název pole klíče a hodnota pro odstraněný záznam. |
| Values |
Získá slovník párů název/hodnota pole bez klíče pro odstraněný záznam. |
Metody
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
