Freigeben über


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.

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

Boolean

true, um die integrierten Steuerelemente zum Einfügen eines neuen Datensatzes anzuzeigen, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateInsertButton Eigenschaft verwendet wird, um die integrierten Steuerelemente anzuzeigen, um einen neuen Datensatz in ein DetailsView Steuerelement einzufügen.


<%@ 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 Datenquellensteuerelement, das das Einfügen unterstützt, an ein DetailsView Steuerelement gebunden ist, kann das DetailsView Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Einfügenfunktionen bereitstellen.

Hinweis

Für ein Datenquellensteuerelement zum Einfügen von Daten muss die SqlDataSource.InsertCommand Eigenschaft mit einer Insert-Abfrage-Anweisung festgelegt werden.

Wenn die AutoGenerateInsertButton Eigenschaft auf true"" festgelegt ist, wird ein Zeilenfeld mit einer CommandField Schaltfläche "Neu" automatisch im DetailsView Steuerelement angezeigt. Durch Klicken auf die Schaltfläche "Neu" wird dieses DetailsView Steuerelement im Einfügemodus eingefügt. Im Einfügenmodus zeigt jedes gebundene Feld im Steuerelement, das nicht schreibgeschützt ist, das entsprechende Eingabesteuerelement, z. B. ein TextBox Steuerelement, für den Datentyp des Felds an. Dadurch kann der Benutzer den Wert des Felds für den neuen Datensatz eingeben.

Wenn Sie auf klicken, wird die Schaltfläche "Neu" auch durch eine Schaltfläche "Einfügen" und eine Schaltfläche "Abbrechen" ersetzt. Durch Klicken auf die Schaltfläche "Einfügen" wird der neue Datensatz in die Datenquelle eingefügt und das Steuerelement in den vom Eigenschaft angegebenen DefaultMode Modus zurückgegeben. Durch Klicken auf die Schaltfläche "Abbrechen" wird der Einfügenvorgang abgebrochen und das Steuerelement in den Standardmodus zurückgegeben.

Hinweis

Um eine Zeile programmgesteuert in einzufügen, verwenden Sie die ChangeMode Methode.

Sie können die Darstellung eines Datensatzes steuern, der sich im Einfügenmodus befindet, indem Sie die InsertRowStyle Eigenschaft verwenden. Allgemeine Einstellungen umfassen in der Regel eine benutzerdefinierte Hintergrundfarbe, Vordergrundfarbe und Schriftarteigenschaften.

Das DetailsView Steuerelement bietet mehrere Ereignisse, mit denen Sie eine benutzerdefinierte Aktion ausführen können, wenn ein neuer Datensatz eingefügt wird. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.

Ereignis BESCHREIBUNG
ItemInserted Tritt auf, wenn die Schaltfläche "Einfügen" geklickt wird, aber nachdem das DetailsView Steuerelement den Datensatz eingefügt hat. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Einfügenvorgangs zu überprüfen.
ItemInserting Tritt auf, wenn die Schaltfläche "Einfügen" geklickt wird, aber bevor das DetailsView Steuerelement den Datensatz einfügt. Dieses Ereignis wird häufig verwendet, um den Einfügenvorgang abzubrechen.
ModeChanged Tritt auf, nachdem die DetailsView Steuerelementmodi geändert wurden.
ModeChanging Tritt auf, bevor die DetailsView Steuerelementmodi geändert werden. Dieses Ereignis wird häufig verwendet, um die Änderung des Modus abzubrechen.

Der Wert AutoGenerateInsertButton wird im Ansichtszustand gespeichert.

Gilt für

Siehe auch