GridView.RowDeleting Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque le bouton Supprimer d’une ligne est cliqué, mais avant que le GridView contrôle supprime la ligne.
public:
event System::Web::UI::WebControls::GridViewDeleteEventHandler ^ RowDeleting;public event System.Web.UI.WebControls.GridViewDeleteEventHandler RowDeleting;member this.RowDeleting : System.Web.UI.WebControls.GridViewDeleteEventHandler Public Custom Event RowDeleting As GridViewDeleteEventHandler Type d'événement
Exemples
L’exemple suivant montre comment utiliser l’événement RowDeleting pour annuler l’opération de suppression. La page contient un GridView contrôle qui affiche la liste des noms et adresses des clients de la base de données AdventureWorksLT. Lorsque l’utilisateur clique sur le lien Supprimer pour une ligne, le gestionnaire de l’événement RowDeleting vérifie le nom de la personne affichée dans la ligne que l’utilisateur tente de supprimer. Si le nom est « Beaver », l’opération de suppression est annulée et un message d’erreur s’affiche. Pour tout autre nom, l’opération de suppression se poursuit et la ligne est supprimée.
Le gestionnaire d’événements utilise la RowIndex propriété de l’objet GridViewDeleteEventArgs pour rechercher la ligne que l’utilisateur tente de supprimer. L’exemple examine le contenu de la Rows collection. Si la valeur à laquelle vous souhaitez effectuer une comparaison est une valeur clé, vous pouvez examiner la collection à la DataKeys place.
Les lignes sont supprimées de la table CustomerAddress au lieu de la table Customer afin de simplifier l’exemple. Le GridView contrôle affiche le résultat de la jointure de trois tables : Customer, Address et CustomerAddress. Lorsqu’une ligne CustomerAddress est supprimée, la ligne correspondante GridView disparaît. Les contraintes d’intégrité référentielle rendent le code d’un exemple qui supprime réellement les lignes de la table Customer plus complexe.
Pour plus d’informations sur la configuration de la base de données AdventureWorksLT, consultez How to : Set Up an AdventureWorksLT Sample Database for ASP.NET Development.
<%@ 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_RowDeleting
(Object sender, GridViewDeleteEventArgs e)
{
TableCell cell = CustomersGridView.Rows[e.RowIndex].Cells[2];
if (cell.Text == "Beaver")
{
e.Cancel = true;
Message.Text = "You cannot delete customer Beaver.";
}
else
{
Message.Text = "";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>GridView RowDeleting Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>
GridView RowDeleting Example
</h3>
<asp:Label ID="Message" ForeColor="Red" runat="server" />
<br />
<asp:GridView ID="CustomersGridView" runat="server"
DataSourceID="CustomersSqlDataSource"
AutoGenerateColumns="False"
AutoGenerateDeleteButton="True"
OnRowDeleting="CustomersGridView_RowDeleting"
DataKeyNames="CustomerID,AddressID">
<Columns>
<asp:BoundField DataField="FirstName"
HeaderText="FirstName" SortExpression="FirstName" />
<asp:BoundField DataField="LastName" HeaderText="LastName"
SortExpression="LastName" />
<asp:BoundField DataField="City" HeaderText="City"
SortExpression="City" />
<asp:BoundField DataField="StateProvince" HeaderText="State"
SortExpression="StateProvince" />
</Columns>
</asp:GridView>
<asp:SqlDataSource ID="CustomersSqlDataSource" runat="server"
SelectCommand="SELECT SalesLT.CustomerAddress.CustomerID,
SalesLT.CustomerAddress.AddressID,
SalesLT.Customer.FirstName,
SalesLT.Customer.LastName,
SalesLT.Address.City,
SalesLT.Address.StateProvince
FROM SalesLT.Customer
INNER JOIN SalesLT.CustomerAddress
ON SalesLT.Customer.CustomerID =
SalesLT.CustomerAddress.CustomerID
INNER JOIN SalesLT.Address ON SalesLT.CustomerAddress.AddressID =
SalesLT.Address.AddressID"
DeleteCommand="Delete from SalesLT.CustomerAddress where CustomerID =
@CustomerID and AddressID = @AddressID"
ConnectionString="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>">
<DeleteParameters>
<asp:Parameter Name="AddressID" />
<asp:Parameter Name="CustomerID" />
</DeleteParameters>
</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">
Private Sub CustomersGridView_RowDeleting _
(ByVal sender As [Object], _
ByVal e As GridViewDeleteEventArgs)
Dim cell As TableCell
cell = CustomersGridView.Rows(e.RowIndex).Cells(2)
If cell.Text = "Beaver" Then
e.Cancel = True
Message.Text = "You cannot delete customer Beaver."
Else
Message.Text = ""
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>GridView RowDeleting Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>
GridView RowDeleting Example
</h3>
<asp:Label ID="Message" ForeColor="Red" runat="server" />
<br />
<asp:GridView ID="CustomersGridView" runat="server"
DataSourceID="CustomersSqlDataSource"
AutoGenerateColumns="False"
AutoGenerateDeleteButton="True"
OnRowDeleting="CustomersGridView_RowDeleting"
DataKeyNames="CustomerID,AddressID">
<Columns>
<asp:BoundField DataField="FirstName"
HeaderText="FirstName" SortExpression="FirstName" />
<asp:BoundField DataField="LastName" HeaderText="LastName"
SortExpression="LastName" />
<asp:BoundField DataField="City" HeaderText="City"
SortExpression="City" />
<asp:BoundField DataField="StateProvince" HeaderText="State"
SortExpression="StateProvince" />
</Columns>
</asp:GridView>
<asp:SqlDataSource ID="CustomersSqlDataSource" runat="server"
SelectCommand="SELECT SalesLT.CustomerAddress.CustomerID,
SalesLT.CustomerAddress.AddressID,
SalesLT.Customer.FirstName,
SalesLT.Customer.LastName,
SalesLT.Address.City,
SalesLT.Address.StateProvince
FROM SalesLT.Customer
INNER JOIN SalesLT.CustomerAddress
ON SalesLT.Customer.CustomerID =
SalesLT.CustomerAddress.CustomerID
INNER JOIN SalesLT.Address ON SalesLT.CustomerAddress.AddressID =
SalesLT.Address.AddressID"
DeleteCommand="Delete from SalesLT.CustomerAddress where CustomerID =
@CustomerID and AddressID = @AddressID"
ConnectionString="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>">
<DeleteParameters>
<asp:Parameter Name="AddressID" />
<asp:Parameter Name="CustomerID" />
</DeleteParameters>
</asp:SqlDataSource>
</form>
</body>
</html>
Remarques
L’événement est déclenché lorsque le RowDeleting bouton Supprimer d’une ligne est cliqué, mais avant que le GridView contrôle supprime la ligne. Cela vous permet de fournir une méthode de gestion des événements qui effectue une routine personnalisée, telle que l’annulation de l’opération de suppression, chaque fois que cet événement se produit.
Un GridViewDeleteEventArgs objet est transmis à la méthode de gestion des événements, qui vous permet de déterminer l’index de la ligne active et d’indiquer que l’opération de suppression doit être annulée. Pour annuler l’opération de suppression, définissez la Cancel propriété de l’objet GridViewDeleteEventArgs sur true. Vous pouvez également manipuler les collections et Values les Keys collections, si nécessaire, avant que les valeurs ne soient transmises à la source de données.
Pour plus d’informations sur la gestion des événements, consultez Gestion et déclenchement d’événements.
