DetailsView.AutoGenerateEditButton Eigenschap

Definitie

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

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de ingebouwde besturingselementen voor het bewerken van de huidige record worden weergegeven in een DetailsView besturingselement.

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

Waarde van eigenschap

Boolean

true om de ingebouwde besturingselementen weer te geven om de huidige record te bewerken; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AutoGenerateEditButton eigenschap gebruikt om de ingebouwde besturingselementen weer te geven om de huidige record te bewerken.


<%@ 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>

Opmerkingen

Wanneer een besturingselement voor gegevensbronnen dat ondersteuning biedt voor het bijwerken afhankelijk is van een DetailsView besturingselement, kan het DetailsView besturingselement profiteren van de mogelijkheden van het gegevensbronbeheer en de functionaliteit voor automatisch bijwerken bieden.

Note

Voor een besturingselement voor gegevensbronnen om gegevens bij te werken, SqlDataSource.UpdateCommand moet de eigenschap worden ingesteld met een updatequery-instructie.

Wanneer de AutoGenerateEditButton eigenschap is ingesteld op true, wordt automatisch een CommandField rijveld met een knop Bewerken weergegeven in het DetailsView besturingselement. Als u op de knop Bewerken klikt, wordt dat DetailsView besturingselement in de bewerkingsmodus geplaatst. In de bewerkingsmodus geeft elk afhankelijk veld in het besturingselement dat niet alleen-lezen is het juiste invoerbesturingselement weer, zoals een TextBox besturingselement, voor het gegevenstype van het veld. Hierdoor kan de gebruiker de waarde van het veld wijzigen.

Wanneer erop wordt geklikt, wordt de knop Bewerken ook vervangen door een knop Bijwerken en een knop Annuleren. Als u op de knop Bijwerken klikt, wordt de record in de gegevensbron bijgewerkt met eventuele waardewijzigingen en wordt het besturingselement geretourneerd naar de modus die is opgegeven door de DefaultMode eigenschap. Als u op de knop Annuleren klikt, worden alle waardewijzigingen afgelaten en wordt het besturingselement teruggelaten naar de standaardmodus.

Note

Als u een DetailsView besturingselement programmatisch in de bewerkingsmodus wilt plaatsen, gebruikt u de ChangeMode methode.

Wanneer de AutoGenerateRows eigenschap ook is ingesteld trueop, zorgt het DetailsView besturingselement er automatisch voor dat het veld of de velden die zijn opgegeven in de DataKeyNames eigenschap alleen-lezen zijn.

Note

Tenzij u uw eigen updatefunctionaliteit implementeert, moet u de DataKeyNames eigenschap zo instellen dat de functie voor automatisch bijwerken werkt.

U kunt het uiterlijk van de gegevensrijen bepalen wanneer het besturingselement zich in de DetailsView bewerkingsmodus bevindt met behulp van de EditRowStyle eigenschap. Algemene instellingen zijn meestal een aangepaste achtergrondkleur, voorgrondkleur en lettertype-eigenschappen.

Het DetailsView besturingselement biedt verschillende gebeurtenissen die u kunt gebruiken om een aangepaste actie uit te voeren wanneer een record wordt bijgewerkt. De volgende tabel bevat de beschikbare gebeurtenissen.

Gebeurtenis Beschrijving
ItemUpdated Treedt op wanneer op de knop Bijwerken wordt geklikt, maar nadat het DetailsView besturingselement de record heeft bijgewerkt. Deze gebeurtenis wordt vaak gebruikt om de resultaten van de updatebewerking te controleren.
ItemUpdating Treedt op wanneer op de knop Bijwerken wordt geklikt, maar voordat het besturingselement de DetailsView record bijwerkt. Deze gebeurtenis wordt vaak gebruikt om de updatebewerking te annuleren.
ModeChanged Vindt plaats nadat de modi van het DetailsView besturingselement zijn gewijzigd.
ModeChanging Vindt plaats voordat de modi van het DetailsView besturingselement worden gewijzigd. Deze gebeurtenis wordt vaak gebruikt om de moduswijziging te annuleren.

De waarde van AutoGenerateEditButton wordt opgeslagen in de weergavestatus.

Van toepassing op

Zie ook