Freigeben über

DetailsView.AutoGenerateInsertButton Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die integrierten Steuerelemente zum Einfügen eines neuen Datensatzes in einem DetailsView Steuerelement angezeigt werden.

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

trueum die integrierten Steuerelemente anzuzeigen, um einen neuen Datensatz einzufügen; andernfalls . false Der Standardwert lautet false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateInsertButton Eigenschaft zum Anzeigen der integrierten Steuerelemente verwendet wird, 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ügefunktionen bereitstellen.

Hinweis

Damit ein Datenquellensteuerelement Daten einfügt, muss seine SqlDataSource.InsertCommand Eigenschaft mit einer Einfügeabfrage-Anweisung festgelegt werden.

Wenn die AutoGenerateInsertButton Eigenschaft auf true festgelegt ist, wird automatisch ein CommandField Zeilenfeld mit einer Schaltfläche "Neu" im DetailsView Steuerelement angezeigt. Durch Klicken auf die Schaltfläche "Neu" wird dieses DetailsView Steuerelement in den Einfügemodus versetzt. Im Einfügemodus 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. Auf diese Weise kann der Benutzer den Wert des Felds für den neuen Datensatz eingeben.

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

Hinweis

Verwenden Sie die ChangeMode Methode, um eine Zeile programmgesteuert in den Einfügemodus zu setzen.

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

Das DetailsView Steuerelement stellt mehrere Ereignisse bereit, 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 auf 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ügevorgangs zu überprüfen.
ItemInserting Tritt auf, wenn auf 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ügevorgang abzubrechen.
ModeChanged Tritt ein, nachdem sich das DetailsView Steuerelement geändert hat.
ModeChanging Tritt auf, bevor das DetailsView Steuerelement Modi ändert. Dieses Ereignis wird häufig verwendet, um die Änderung des Modus abzubrechen.

Der Wert von wird im Ansichtszustand AutoGenerateInsertButton gespeichert.

Gilt für:

Weitere Informationen