CommandField.ShowInsertButton Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab, der angibt, ob eine Neu-Schaltfläche in einem CommandField-Feld angezeigt wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, um eine Neu-Schaltfläche in einem CommandField anzuzeigen, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ShowInsertButton -Eigenschaft verwendet wird, um die Schaltfläche Neu in einem DetailsView Steuerelement anzuzeigen, mit der der Benutzer der Datenquelle einen neuen Datensatz hinzufügen kann.


<%@ 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:detailsview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneraterows="false"
        datakeynames="CustomerID"  
        allowpaging="true" 
        runat="server">
        
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="CompanyName"/>
          <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"/>
          <asp:commandfield showinsertbutton="true"
            showheader="true"
            headertext="Add Customer"/>
        </fields>
        
      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
        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:detailsview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneraterows="false"
        datakeynames="CustomerID"  
        allowpaging="true" 
        runat="server">
        
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="CompanyName"/>
          <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"/>
          <asp:commandfield showinsertbutton="true"
            showheader="true"
            headertext="Add Customer"/>
        </fields>
        
      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Hinweise

Verwenden Sie die ShowInsertButton -Eigenschaft, um anzugeben, ob die Schaltfläche Neu in einem CommandField Feld angezeigt wird. Die Schaltfläche Neu wird nur einmal im CommandField Feld angezeigt und ermöglicht dem Benutzer das Hinzufügen eines neuen Datensatzes in der Datenquelle.

Hinweis

Diese Eigenschaft gilt nur für datengebundene Steuerelemente, die Einfügevorgänge unterstützen, z. B. das DetailsView -Steuerelement.

Wenn der Benutzer auf die Schaltfläche Neu klickt, werden Eingabesteuerelemente für jedes Feld angezeigt, das im datengebundenen Steuerelement angezeigt wird, sodass der Benutzer die Werte für den neuen Datensatz eingeben kann. Die Schaltfläche Neu wird durch die Schaltfläche Einfügen und die Schaltfläche Abbrechen ersetzt, und alle anderen Befehlsschaltflächen im CommandField Feld sind ausgeblendet. Durch Klicken auf die Schaltfläche Einfügen wird der Datensatz der Datenquelle hinzugefügt, während durch Klicken auf die Schaltfläche Abbrechen der Vorgang abgebrochen wird.

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 Einfügefunktionen bereitstellen. Für andere Datenquellen müssen Sie die Routinen angeben, um den Einfügevorgang während des entsprechenden Ereignisses für das datengebundene Steuerelement auszuführen.

Wenn die ButtonType -Eigenschaft eines CommandField Felds auf ButtonType.Button oder ButtonType.Linkfestgelegt ist, verwenden Sie die NewText -Eigenschaft, um den Text anzugeben, der für eine Schaltfläche Neu angezeigt werden soll. Alternativ können Sie ein Bild anzeigen, indem Sie zuerst die ButtonType -Eigenschaft auf ButtonType.Image und dann die NewImageUrl -Eigenschaft festlegen.

Gilt für:

Weitere Informationen