DetailsView.AutoGenerateEditButton Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die integrierten Steuerelemente zum Bearbeiten des aktuellen Datensatzes in einem DetailsView-Steuerelement angezeigt werden, oder legt diesen Wert fest.Gets or sets a value indicating whether the built-in controls to edit the current record are displayed in a DetailsView control.

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

Eigenschaftswert

true, um die integrierten Steuerelemente zum Bearbeiten des aktuellen Datensatzes anzuzeigen, andernfalls false.true to display the built-in controls to edit the current record; otherwise, false. Der Standardwert lautet false.The default is false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateEditButton-Eigenschaft verwendet wird, um die integrierten Steuerelemente zum Bearbeiten des aktuellen Datensatzes anzuzeigen.The following code example demonstrates how to use the AutoGenerateEditButton property to display the built-in controls to edit the current record.


<%@ 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 AutoGenerateEditButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateEditButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="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 AutoGenerateEditButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateEditButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="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 das Aktualisieren unterstützt, an ein DetailsView-Steuerelement gebunden ist, kann das DetailsView Steuerelement die Funktionen des Datenquellen-Steuer Elements nutzen und automatische Aktualisierungs Funktionen bereitstellen.When a data source control that supports updating is bound to a DetailsView control, the DetailsView control can take advantage of the data source control's capabilities and provide automatic updating functionality.

Hinweis

Damit ein Datenquellen-Steuerelement Daten aktualisiert, muss dessen SqlDataSource.UpdateCommand-Eigenschaft mit einer Update Query-Anweisung festgelegt werden.For a data source control to update data, its SqlDataSource.UpdateCommand property must be set with an update query statement.

Wenn die AutoGenerateEditButton-Eigenschaft auf truefestgelegt ist, wird im DetailsView Steuerelement automatisch ein CommandField Zeilen Feld mit der Schaltfläche "Bearbeiten" angezeigt.When the AutoGenerateEditButton property is set to true, a CommandField row field with an Edit button is automatically displayed in the DetailsView control. Wenn Sie auf die Schaltfläche Bearbeiten klicken, wird diese DetailsView Steuerelement im Bearbeitungsmodus abgelegtClicking the Edit button puts that DetailsView control in edit mode. Im Bearbeitungsmodus 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 edit 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 ändern.This allows the user to modify the field's value.

Wenn Sie darauf klicken, wird die Bearbeitungs Schaltfläche auch durch eine Update Schaltfläche und eine Schaltfläche Abbrechen ersetzt.When clicked, the Edit button is also replaced with an Update button and a Cancel button. Durch Klicken auf die Schaltfläche Aktualisieren wird der Datensatz in der Datenquelle mit beliebigen Wertänderungen aktualisiert, und das Steuerelement wird in den von der DefaultMode-Eigenschaft angegebenen Modus zurückgegeben.Clicking the Update button updates the record in the data source with any value changes and returns the control to the mode specified by the DefaultMode property. Durch Klicken auf die Schaltfläche Abbrechen werden alle Werte geändert und das Steuerelement in den Standardmodus zurückgegeben.Clicking the Cancel button abandons any value changes and returns the control to the default mode.

Hinweis

Verwenden Sie die ChangeMode-Methode, um ein DetailsView-Steuerelement Programm gesteuert in den Bearbeitungsmodus zu versetzen.To put a DetailsView control in edit mode programmatically, use the ChangeMode method.

Wenn die AutoGenerateRows-Eigenschaft ebenfalls auf truefestgelegt ist, stellt das DetailsView-Steuerelement automatisch sicher, dass das in der DataKeyNames-Eigenschaft angegebene Feld oder die Felder schreibgeschützt sind.When the AutoGenerateRows property is also set to true, the DetailsView control automatically ensures that the field or fields specified in the DataKeyNames property are read-only.

Hinweis

Wenn Sie keine eigene Aktualisierungs Funktionalität implementieren, müssen Sie die DataKeyNames-Eigenschaft festlegen, damit das Feature für automatische Updates funktioniert.Unless you implement your own updating functionality, you must set the DataKeyNames property for the automatic updating feature to work.

Sie können die Darstellung der Daten Zeilen steuern, wenn sich das DetailsView-Steuerelement im Bearbeitungsmodus befindet, indem Sie die EditRowStyle-Eigenschaft verwenden.You can control the appearance of the data rows when the DetailsView control is in edit mode by using the EditRowStyle 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 Datensatz aktualisiert wird.The DetailsView control provides several events that you can use to perform a custom action when a record is updated. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.The following table lists the available events.

EreignisEvent BESCHREIBUNGDescription
ItemUpdated Tritt auf, wenn auf die Schaltfläche Aktualisieren geklickt wird, aber nachdem das DetailsView-Steuerelement den Datensatz aktualisiert hat.Occurs when the Update button is clicked, but after the DetailsView control updates the record. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Aktualisierungs Vorgangs zu überprüfen.This event is often used to check the results of the update operation.
ItemUpdating Tritt auf, wenn auf die Schaltfläche Aktualisieren geklickt wird, aber bevor das DetailsView-Steuerelement den Datensatz aktualisiert.Occurs when the Update button is clicked, but before the DetailsView control updates the record. Dieses Ereignis wird häufig verwendet, um den Aktualisierungs Vorgang abzubrechen.This event is often used to cancel the update 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 AutoGenerateEditButton wird im Ansichts Zustand gespeichert.The value of AutoGenerateEditButton is stored in view state.

Gilt für:

Siehe auch