DetailsViewDeletedEventArgs Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

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 ItemDeleted.

public ref class DetailsViewDeletedEventArgs : EventArgs

public class DetailsViewDeletedEventArgs : EventArgs

type DetailsViewDeletedEventArgs = class
    inherit EventArgs

Public Class DetailsViewDeletedEventArgs
Inherits EventArgs

Dědičnost: Object

EventArgs
DetailsViewDeletedEventArgs

Příklady

Následující příklad kódu ukazuje, jak použít DetailsViewDeletedEventArgs objekt předaný obslužné rutině ItemDeleted události události 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 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>

Poznámky

Ovládací DetailsView prvek vyvolá ItemDeleted událost, když se v ovládacím prvku klikne tlačítko Delete (tlačítko s jeho CommandName vlastností nastavenou na "Delete"), ale po DetailsView odstranění záznamu ovládací prvek. To vám umožní poskytnout obslužnou rutinu události, která provádí vlastní rutinu, například kontrolu výsledků operace odstranění, kdykoli dojde k této události.

DetailsViewDeletedEventArgs Objekt se předá obslužné rutině události, která umožňuje určit počet ovlivněných záznamů a všechny výjimky, ke kterým mohlo dojít. K určení počtu záznamů ovlivněných operací odstranění použijte AffectedRows vlastnost. Exception Pomocí vlastnosti určete, zda došlo k výjimkám. Můžete také určit, zda byla výjimka zpracována v obslužné rutině události nastavením ExceptionHandled vlastnosti. Pokud chcete získat přístup ke párům název/hodnota polí klíčů a polí, která nejsou klíčem odstraněného záznamu, použijte hodnoty Keys a Values vlastnosti.

Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.

Seznam počátečních hodnot vlastností pro instanci DetailsViewDeletedEventArgs třídy naleznete v konstruktoru DetailsViewDeletedEventArgs .

Konstruktory

Name	Description
DetailsViewDeletedEventArgs(Int32, Exception)	Inicializuje novou instanci DetailsViewDeletedEventArgs třídy.

Vlastnosti

Name	Description
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 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/hodnota pole klíče, který obsahuje názvy a hodnoty klíčových polí odstraněných položek.
Values	Získá slovník párů název/hodnota pole bez klíče pro položku k odstranění.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?