DetailsView.AutoGenerateDeleteButton Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore che indica se in un controllo DetailsView viene visualizzato il controllo incorporato di eliminazione del record corrente.

public:
 virtual property bool AutoGenerateDeleteButton { bool get(); void set(bool value); };
public virtual bool AutoGenerateDeleteButton { get; set; }
member this.AutoGenerateDeleteButton : bool with get, set
Public Overridable Property AutoGenerateDeleteButton As Boolean

Valore della proprietà

Boolean

true per visualizzare il controllo incorporato di eliminazione del record corrente; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la AutoGenerateDeleteButton proprietà per visualizzare il controllo predefinito per eliminare il record corrente.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView AutoGenerateDeleteButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateDeleteButton Example</h3>
                
        <asp:detailsview id="CustomersDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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" runat="server" 
            ConnectionString=
              "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], 
              [CompanyName], [Address], [City], [PostalCode], [Country]) 
              VALUES (@CustomerID, @CompanyName, @Address, @City, 
              @PostalCode, @Country)"
            SelectCommand="Select [CustomerID], [CompanyName], 
              [Address], [City], [PostalCode], [Country] From 
              [Customers]">
        </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView AutoGenerateDeleteButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateDeleteButton Example</h3>
                
        <asp:detailsview id="CustomersDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneratedeletebutton="true"  
          autogeneraterows="true"
          allowpaging="true"  
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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" runat="server" 
            ConnectionString=
              "<%$ ConnectionStrings:NorthWindConnectionString%>"
            InsertCommand="INSERT INTO [Customers]([CustomerID], 
              [CompanyName], [Address], [City], [PostalCode], [Country]) 
              VALUES (@CustomerID, @CompanyName, @Address, @City, 
              @PostalCode, @Country)"
            SelectCommand="Select [CustomerID], [CompanyName], 
              [Address], [City], [PostalCode], [Country] From 
              [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Commenti

Quando un controllo è associato a un DetailsView oggetto che eredita da DataSourceView e la CanDelete proprietà restituisce true, il DetailsView controllo può sfruttare le funzionalità del controllo origine dati e fornire funzionalità di eliminazione automatica.

Nota

SqlDataSourceView Per eliminare i dati, è necessario impostare la SqlDataSource.DeleteCommand proprietà dell'oggetto sottostante SqlDataSource con un'istruzione di query di eliminazione.

Quando la AutoGenerateDeleteButton proprietà è impostata su true, un CommandField campo di riga con un pulsante Delete viene visualizzato automaticamente nel DetailsView controllo. Facendo clic sul pulsante Elimina rimuove definitivamente il record dall'origine dati.

Nota

È anche necessario impostare la DataKeyNames proprietà per il funzionamento della funzionalità di eliminazione automatica.

Il DetailsView controllo fornisce diversi eventi che è possibile usare per eseguire un'azione personalizzata quando un record viene eliminato. Nella tabella seguente sono elencati gli eventi disponibili.

Event Descrizione
ItemDeleted Si verifica quando viene fatto clic sul pulsante Elimina, ma dopo che il controllo elimina il DetailsView record dall'origine dati. Questo evento viene spesso usato per controllare i risultati dell'operazione di eliminazione.
ItemDeleting Si verifica quando viene fatto clic sul pulsante Elimina, ma prima che il controllo elimini il DetailsView record dall'origine dati. Questo evento viene spesso usato per annullare l'operazione di eliminazione.

Il valore di viene archiviato nello stato di AutoGenerateDeleteButton visualizzazione.

Si applica a

Vedi anche