DetailsViewDeleteEventArgs.Keys Proprietà

Definizione

Ottiene un dizionario ordinato delle coppie nome/valore dei campi chiave che contiene i nomi e i valori dei campi chiave degli elementi eliminati.

public System.Collections.Specialized.IOrderedDictionary Keys { get; }

Valore della proprietà

IOrderedDictionary

Oggetto IOrderedDictionary che contiene un dizionario ordinato delle coppie nome/valore dei campi chiave utilizzato per individuare l'elemento da eliminare.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la Keys proprietà per accedere al valore del campo chiave per il record eliminato.


<%@ 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>

Commenti

Utilizzare la Keys proprietà per accedere ai valori del campo chiave o dei campi per l'eliminazione del record. Ad esempio, è possibile usare questi valori per verificare il record prima di eliminarlo, per modificare il record da eliminare o per mantenere un log di record eliminati.

Nota

Questa proprietà contiene solo i campi chiave. Per accedere ai valori di coppia nome/valore per i campi non chiave, usare la Values proprietà .

La proprietà Keys restituisce un oggetto che implementa l'interfaccia IOrderedDictionary. L'oggetto contiene DictionaryEntry oggetti che rappresentano i campi chiave.

Nota

Come collegamento, è anche possibile usare l'indicizzatore dell'oggetto IOrderedDictionary per accedere ai valori del campo chiave. Il vantaggio nell'uso dell'indicizzatore è che restituisce direttamente i valori del campo chiave.

Questa proprietà è di sola lettura; È tuttavia possibile modificare i valori del campo chiave dell'oggetto IOrderedDictionary restituito. Se si modificano i valori del campo chiave, il record corrispondente viene eliminato dall'origine dati.

Si applica a

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Vedi anche