DetailsViewDeleteEventArgs Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Biedt gegevens voor de ItemDeleting gebeurtenis.

public ref class DetailsViewDeleteEventArgs : System::ComponentModel::CancelEventArgs

public class DetailsViewDeleteEventArgs : System.ComponentModel.CancelEventArgs

type DetailsViewDeleteEventArgs = class
    inherit CancelEventArgs

Public Class DetailsViewDeleteEventArgs
Inherits CancelEventArgs

Overname: Object

EventArgs

CancelEventArgs
DetailsViewDeleteEventArgs

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u het DetailsViewDeleteEventArgs object gebruikt dat is doorgegeven aan de gebeurtenis-handler om ItemDeleting een verwijderbewerking te annuleren.


<%@ 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 CustomerDetailsView_ItemDeleting(Object sender, 
    DetailsViewDeleteEventArgs e)
  {

    // Get customer ID and name from the Keys and Values
    // properties.
    String keyValue = e.Keys["CustomerID"].ToString();
    String customerName = e.Values["CompanyName"].ToString();

    // Cancel the delete operation if the user attempts to 
    // delete protected record. In this example, records
    // with a customer ID that starts with with "A" cannot
    // be deleted.
    if (keyValue.StartsWith("A"))
    {
      e.Cancel = true;
      MessageLabel.Text = "You cannot delete " +
        customerName + ". This customer is protected.";
    }
    else
    {
      MessageLabel.Text = "Row " + e.RowIndex.ToString() + 
        " deleted.";
    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewDeleteEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewDeleteEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          onitemdeleting="CustomerDetailsView_ItemDeleting" 
          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" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub CustomerDetailsView_ItemDeleting(ByVal sender As Object, _
    ByVal e As DetailsViewDeleteEventArgs)

    ' Get customer ID and name from the Keys and Values
    ' properties.
    Dim keyValue As String = e.Keys("CustomerID").ToString()
    Dim customerName As String = e.Values("CompanyName").ToString()

    ' Cancel the delete operation if the user attempts to 
    ' delete protected record. In this example, records
    ' with a customer ID that starts with with "A" cannot
    ' be deleted.
    If keyValue.StartsWith("A") Then

      e.Cancel = True
      MessageLabel.Text = "You cannot delete " & _
        customerName & ". This customer is protected."
    
    Else
    
      MessageLabel.Text = "Row " & e.RowIndex.ToString() & _
        " deleted."
    
    End If
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewDeleteEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewDeleteEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          onitemdeleting="CustomerDetailsView_ItemDeleting" 
          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>

Opmerkingen

Het DetailsView besturingselement haalt de ItemDeleting gebeurtenis op wanneer een knop Verwijderen (een knop met CommandName de eigenschap ingesteld op Verwijderen) binnen het besturingselement wordt geklikt, maar voordat het besturingselement de DetailsView record verwijdert. Hiermee kunt u een gebeurtenishandler opgeven die een aangepaste routine uitvoert, zoals het verifiëren van een record voordat u deze verwijdert, wanneer deze gebeurtenis plaatsvindt.

Een DetailsViewDeletedEventArgs object wordt doorgegeven aan de gebeurtenis-handler, waarmee u kunt bepalen welke index van de record wordt verwijderd en om aan te geven dat de verwijderbewerking moet worden geannuleerd. Gebruik de RowIndex eigenschap om de index van een record te bepalen. Als u de verwijderbewerking wilt annuleren, stelt u de Cancel eigenschap in op true. U kunt ook toegang krijgen tot de sleutelvelden en niet-sleutelvelden door respectievelijk de Keys en Values eigenschappen te gebruiken. Deze waarden zijn handig als u de record wilt controleren voordat u deze verwijdert.

Note

Het is mogelijk om de sleutelveldwaarden in de Keys eigenschap te wijzigen. Als u deze waarden wijzigt, wordt de record die overeenkomt met de nieuwe sleutelveldwaarden verwijderd.

Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.

Zie de DetailsViewDeleteEventArgs constructor voor een lijst met initiële eigenschapswaarden voor een exemplaar van DetailsViewDeleteEventArgs klasse.

Constructors

Name	Description
DetailsViewDeleteEventArgs(Int32)	Initialiseert een nieuw exemplaar van de DetailsViewDeleteEventArgs klasse.

Eigenschappen

Name	Description
Cancel	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebeurtenis moet worden geannuleerd. (Overgenomen van CancelEventArgs)
Keys	Hiermee haalt u een geordende woordenlijst op van sleutelveldnaam-waardeparen die de namen en waarden van de sleutelvelden van de verwijderde items bevatten.
RowIndex	Hiermee haalt u de index op van de rij die wordt verwijderd.
Values	Hiermee haalt u een woordenlijst op van de niet-sleutelveldnaam/waardeparen voor het item dat moet worden verwijderd.

Methoden

Name	Description
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?