DetailsView.AutoGenerateDeleteButton Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает значение, позволяющее определить, отображается ли встроенный элемент управления для удаления текущей записи в элементе управления DetailsView.

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

Значение свойства

Boolean

Значение true для отображения встроенного элемента управления, удаляющего текущую запись; в противном случае — значение false. Значение по умолчанию — false.

Примеры

В следующем примере кода показано, как использовать AutoGenerateDeleteButton свойство для отображения встроенного элемента управления для удаления текущей записи.


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

Комментарии

DetailsView Когда элемент управления привязан к объекту, наследуемого от DataSourceView , и CanDelete свойство возвращает true, DetailsView элемент управления может воспользоваться преимуществами возможностей элемента управления источником данных и обеспечить автоматическое удаление.

Примечание

SqlDataSourceView Чтобы объект удалял данные, SqlDataSource.DeleteCommand свойство базового SqlDataSource объекта должно быть задано с помощью инструкции запроса на удаление.

Если свойству AutoGenerateDeleteButton присвоено значение true, в DetailsView элементе CommandField управления автоматически отображается поле строки с кнопкой Удалить. Нажатие кнопки Удалить окончательно удаляет эту запись из источника данных.

Примечание

Также необходимо задать DataKeyNames свойство для работы функции автоматического удаления.

Элемент DetailsView управления предоставляет несколько событий, которые можно использовать для выполнения настраиваемого действия при удалении записи. В следующей таблице перечислены доступные события.

Событие Описание
ItemDeleted Происходит при нажатии кнопки Удалить, но после DetailsView того, как элемент управления удаляет запись из источника данных. Это событие часто используется для проверки результатов операции удаления.
ItemDeleting Происходит при нажатии кнопки Удалить, но до того, как DetailsView элемент управления удаляет запись из источника данных. Это событие часто используется для отмены операции удаления.

Значение AutoGenerateDeleteButton хранится в состоянии представления.

Применяется к

См. также раздел