DetailsView.AutoGenerateDeleteButton DetailsView.AutoGenerateDeleteButton DetailsView.AutoGenerateDeleteButton DetailsView.AutoGenerateDeleteButton Property

Definizione

Ottiene o imposta un valore che indica se in un controllo DetailsView viene visualizzato il controllo incorporato di eliminazione del record corrente.Gets or sets a value indicating whether the built-in control to delete the current record is displayed in a DetailsView control.

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à

true per visualizzare il controllo incorporato di eliminazione del record corrente; in caso contrario, false.true to display the built-in control to delete the current record; otherwise, false. Il valore predefinito è false.The default is false.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato AutoGenerateDeleteButton come utilizzare la proprietà per visualizzare il controllo incorporato per eliminare il record corrente.The following code example demonstrates how to use the AutoGenerateDeleteButton property to display the built-in control to delete the current record.


<%@ 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 DetailsView controllo è associato a un oggetto che eredita da DataSourceView e la CanDelete proprietà restituisce true, il DetailsView controllo può sfruttare le funzionalità del controllo origine dati e fornire automaticamente eliminazione della funzionalità.When a DetailsView control is bound to an object that inherits from DataSourceView and the CanDelete property returns true, the DetailsView control can take advantage of the data source control's capabilities and provide automatic deleting functionality.

Nota

Per eliminare SqlDataSourceView i dati in un oggetto, SqlDataSource.DeleteCommand è necessario impostare la SqlDataSource proprietà dell'oggetto sottostante con un'istruzione di query DELETE.For a SqlDataSourceView object to delete data, the SqlDataSource.DeleteCommand property of the underlying SqlDataSource object must be set with a delete query statement.

Quando la AutoGenerateDeleteButton proprietà è impostata su true, nel CommandField DetailsView controllo viene visualizzato automaticamente un campo riga con un pulsante Elimina.When the AutoGenerateDeleteButton property is set to true, a CommandField row field with a Delete button is automatically displayed in the DetailsView control. Se si fa clic sul pulsante Elimina, il record verrà rimosso definitivamente dall'origine dati.Clicking the Delete button permanently removes that record from the data source.

Nota

È inoltre necessario impostare la DataKeyNames proprietà per il funzionamento della funzionalità di eliminazione automatica.You must also set the DataKeyNames property for the automatic deletion feature to work.

Il DetailsView controllo fornisce diversi eventi che è possibile usare per eseguire un'azione personalizzata quando viene eliminato un record.The DetailsView control provides several events that you can use to perform a custom action when a record is deleted. Nella tabella seguente sono elencati gli eventi disponibili.The following table lists the available events.

eventEvent DescriptionDescription
ItemDeleted Si verifica quando si fa clic sul pulsante Elimina, ma dopo DetailsView che il controllo ha eliminato il record dall'origine dati.Occurs when the Delete button is clicked, but after the DetailsView control deletes the record from the data source. Questo evento viene spesso usato per verificare i risultati dell'operazione di eliminazione.This event is often used to check the results of the delete operation.
ItemDeleting Si verifica quando si fa clic sul pulsante Elimina, ma prima DetailsView che il controllo elimini il record dall'origine dati.Occurs when the Delete button is clicked, but before the DetailsView control deletes the record from the data source. Questo evento viene spesso utilizzato per annullare l'operazione di eliminazione.This event is often used to cancel the delete operation.

Il valore di AutoGenerateDeleteButton viene archiviato nello stato di visualizzazione.The value of AutoGenerateDeleteButton is stored in view state.

Si applica a

Vedi anche