DetailsView.AutoGenerateEditButton Eigenschaft

  • Referenz

Definition

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

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.

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

Boolean

true, um die integrierten Steuerelemente zum Bearbeiten des aktuellen Datensatzes anzuzeigen, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AutoGenerateEditButton Eigenschaft verwendet wird, um die integrierten Steuerelemente anzuzeigen, um den aktuellen Datensatz zu bearbeiten.


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

Hinweis

Für ein Datenquellensteuerelement zum Aktualisieren von Daten muss seine SqlDataSource.UpdateCommand Eigenschaft mit einer Updateabfrage-Anweisung festgelegt werden.

Wenn die AutoGenerateEditButton Eigenschaft auf true"Festgelegt" festgelegt ist, wird ein CommandField Zeilenfeld mit einer Schaltfläche "Bearbeiten" automatisch im DetailsView Steuerelement angezeigt. Durch Klicken auf die Schaltfläche "Bearbeiten" wird dieses DetailsView Steuerelement im Bearbeitungsmodus platziert. Im Bearbeitungsmodus 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 ändern.

Wenn Sie auf klicken, wird die Schaltfläche "Bearbeiten" auch durch eine Schaltfläche "Aktualisieren" und eine Schaltfläche "Abbrechen" ersetzt. Durch Klicken auf die Schaltfläche "Aktualisieren" wird der Datensatz in der Datenquelle mit beliebigen Wertänderungen aktualisiert und das Steuerelement an den vom Eigenschaft angegebenen DefaultMode Modus zurückgegeben. Durch Klicken auf die Schaltfläche "Abbrechen" werden alle Wertänderungen abgebrochen und das Steuerelement im Standardmodus zurückgegeben.

Hinweis

Verwenden Sie die ChangeMode Methode, um ein DetailsView Steuerelement programmgesteuert im Bearbeitungsmodus zu platzieren.

Wenn die AutoGenerateRows Eigenschaft auch auf truefestgelegt ist, stellt das DetailsView Steuerelement automatisch sicher, dass das feld oder die felder, die in der DataKeyNames Eigenschaft angegeben sind, schreibgeschützt sind.

Hinweis

Es sei denn, Sie implementieren ihre eigene Aktualisierungsfunktionalität, müssen Sie die Eigenschaft für das Feature für die DataKeyNames automatische Aktualisierung festlegen, um zu funktionieren.

Sie können die Darstellung der Datenzeilen steuern, wenn sich das DetailsView Steuerelement im Bearbeitungsmodus befindet, indem Sie die EditRowStyle 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 Datensatz aktualisiert wird. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.

Ereignis BESCHREIBUNG
ItemUpdated Tritt auf, wenn die Schaltfläche "Aktualisieren" geklickt wird, aber nachdem das DetailsView Steuerelement den Datensatz aktualisiert hat. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Updatevorgangs zu überprüfen.
ItemUpdating Tritt auf, wenn die Schaltfläche "Aktualisieren" geklickt wird, aber bevor das DetailsView Steuerelement den Datensatz aktualisiert. Dieses Ereignis wird häufig verwendet, um den Aktualisierungsvorgang 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 AutoGenerateEditButton wird im Ansichtszustand gespeichert.

Gilt für

Siehe auch