Freigeben über

CommandField.ShowDeleteButton Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine Schaltfläche "Löschen" in einem CommandField Feld angezeigt wird.

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

Eigenschaftswert

Boolean

true zum Anzeigen einer Schaltfläche "Löschen" in einem CommandField; andernfalls false. Der Standardwert lautet false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ShowDeleteButton Eigenschaft zum Anzeigen einer Schaltfläche "Löschen" für jeden Datensatz in einem GridView Steuerelement verwendet wird.


<%@ 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showdeletebutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        deletecommand="Delete [Customers] Where [CustomerID] = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showdeletebutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        deletecommand="Delete [Customers] Where [CustomerID] = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Hinweise

Verwenden Sie die ShowDeleteButton Eigenschaft, um anzugeben, ob eine Schaltfläche "Löschen" in einem CommandField Feld für jeden Datensatz im Datenquellensteuerelement angezeigt wird. Mit der Schaltfläche "Löschen" können Sie einen Datensatz aus der Datenquelle entfernen.

Hinweis

Wenn ein datengebundenes Steuerelement in Kombination mit einem Datenquellensteuerelement (z. B. einem SqlDataSource Steuerelement) verwendet wird, kann das datengebundene Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Löschfunktionen bereitstellen. Für andere Datenquellen müssen Sie die Routinen angeben, um den Löschvorgang während des entsprechenden Ereignisses für das datengebundene Steuerelement auszuführen.

Wenn die ButtonType Eigenschaft eines CommandField Felds auf ButtonType.Button "Oder ButtonType.Link" festgelegt ist, geben Sie mit der DeleteText Eigenschaft den Text an, der für eine Schaltfläche "Löschen" angezeigt werden soll. Alternativ können Sie ein Bild anzeigen, indem Sie zuerst die ButtonType Eigenschaft auf ButtonType.Image und dann die DeleteImageUrl Eigenschaft festlegen.

Gilt für:

Weitere Informationen