DetailsView.AutoGenerateInsertButton Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die integrierten Steuerelemente zum Einfügen eines neuen Datensatzes in einem DetailsView-Steuerelement angezeigt werden, oder legt diesen Wert fest.Gets or sets a value indicating whether the built-in controls to insert a new record are displayed in a DetailsView control.

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

Eigenschaftswert

true, um die integrierten Steuerelemente zum Einfügen eines neuen Datensatzes anzuzeigen, andernfalls false.true to display the built-in controls to insert a new record; otherwise, false. Der Standardwert lautet false.The default is false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateInsertButton-Eigenschaft verwendet wird, um die integrierten Steuerelemente zum Einfügen eines neuen Datensatzes in ein DetailsView-Steuerelement anzuzeigen.The following code example demonstrates how to use the AutoGenerateInsertButton property to display the built-in controls to insert a new record in a DetailsView control.


<%@ 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 AutoGenerateInsertButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateInsertButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="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 AutoGenerateInsertButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateInsertButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="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>

Hinweise

Wenn ein Datenquellen Steuerelement, das Einfügevorgang unterstützt, an ein DetailsView Steuerelement gebunden ist, kann das DetailsView Steuerelement die Funktionen des Datenquellen-Steuer Elements nutzen und automatische Einfügefunktionen bereitstellenWhen a data source control that supports inserting is bound to a DetailsView control, the DetailsView control can take advantage of the data source control's capabilities and provide automatic inserting functionality.

Hinweis

Damit ein Datenquellen-Steuerelement Daten einfügen kann, muss dessen SqlDataSource.InsertCommand-Eigenschaft mit einer INSERT-Abfrage Anweisung festgelegt werden.For a data source control to insert data, its SqlDataSource.InsertCommand property must be set with an insert query statement.

Wenn die AutoGenerateInsertButton-Eigenschaft auf truefestgelegt ist, wird im DetailsView Steuerelement automatisch ein CommandField Zeilen Feld mit einer neuen Schaltfläche angezeigt.When the AutoGenerateInsertButton property is set to true, a CommandField row field with a New button is automatically displayed in the DetailsView control. Wenn Sie auf die Schaltfläche "neu" klicken, wird diese DetailsView-Steuerelement imClicking the New button puts that DetailsView control in insert mode. Im Einfügemodus zeigt jedes gebundene Feld im Steuerelement, das nicht schreibgeschützt ist, das entsprechende Eingabe Steuerelement, z. b. ein TextBox Steuerelement, für den Datentyp des Felds an.When in insert mode, each bound field in the control that is not read-only displays the appropriate input control, such as a TextBox control, for the field's data type. Dadurch kann der Benutzer den Wert des Felds für den neuen Datensatz eingeben.This allows the user to enter the field's value for the new record.

Wenn Sie darauf klicken, wird die Schaltfläche neu auch durch eine Schaltfläche Einfügen und eine Schaltfläche Abbrechen ersetzt.When clicked, the New button is also replaced with an Insert button and a Cancel button. Wenn Sie auf die Schaltfläche einfügen klicken, wird der neue Datensatz in die Datenquelle eingefügt, und das Steuerelement wird in den von der Eigenschaft DefaultMode angegebenen Modus zurückgegebenClicking the Insert button inserts the new record in the data source and returns the control to the mode specified by the DefaultMode property. Wenn Sie auf die Schaltfläche Abbrechen klicken, wird der Einfügevorgang abgebrochenClicking the Cancel button abandons the insert operation and returns the control to the default mode.

Hinweis

Verwenden Sie die ChangeMode-Methode, um eine Zeile Programm gesteuert in den Einfügemodus zu versetzen.To put a row in insert mode programmatically, use the ChangeMode method.

Sie können die Darstellung eines Datensatzes im Einfügemodus steuern, indem Sie die InsertRowStyle-Eigenschaft verwenden.You can control the appearance of a record that is in insert mode by using the InsertRowStyle property. Allgemeine Einstellungen umfassen in der Regel eine benutzerdefinierte Hintergrundfarbe, Vordergrundfarbe und Schriftart Eigenschaften.Common settings usually include a custom background color, foreground color, and font properties.

Das DetailsView-Steuerelement stellt mehrere Ereignisse bereit, die Sie verwenden können, um eine benutzerdefinierte Aktion auszuführen, wenn ein neuer Datensatz eingefügt wird.The DetailsView control provides several events that you can use to perform a custom action when a new record is inserted. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.The following table lists the available events.

EreignisEvent BESCHREIBUNGDescription
ItemInserted Tritt auf, wenn auf die Schaltfläche Einfügen geklickt wird, aber nachdem das DetailsView-Steuerelement den Datensatz eingefügt hat.Occurs when the Insert button is clicked, but after the DetailsView control inserts the record. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Einfügevorgangs zu überprüfen.This event is often used to check the results of the insert operation.
ItemInserting Tritt auf, wenn auf die Schaltfläche Einfügen geklickt wird, aber bevor das DetailsView Steuerelement den Datensatz einfügt.Occurs when the Insert button is clicked, but before the DetailsView control inserts the record. Dieses Ereignis wird häufig verwendet, um den Einfügevorgang abzubrechen.This event is often used to cancel the insert operation.
ModeChanged Tritt ein, nachdem die Modi des DetailsView Steuer Elements geändert wurdenOccurs after the DetailsView control changes modes.
ModeChanging Tritt ein, bevor das DetailsView Steuerelement den Modus ändert.Occurs before the DetailsView control changes modes. Dieses Ereignis wird häufig verwendet, um die Modusänderung abzubrechen.This event is often used to cancel the mode change.

Der Wert von AutoGenerateInsertButton wird im Ansichts Zustand gespeichert.The value of AutoGenerateInsertButton is stored in view state.

Gilt für:

Siehe auch