DetailsView.AutoGenerateEditButton Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví hodnotu označující, zda předdefinované ovládací prvky pro úpravu aktuálního záznamu jsou zobrazeny v ovládacím DetailsView prvku.

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

Hodnota vlastnosti

Boolean

true k zobrazení předdefinovaných ovládacích prvků pro úpravu aktuálního záznamu; falsev opačném případě . Výchozí formát je false.

Příklady

Následující příklad kódu ukazuje, jak použít AutoGenerateEditButton vlastnost k zobrazení předdefinovaných ovládacích prvků k úpravě aktuálního záznamu.


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

Poznámky

Pokud je ovládací prvek zdroje dat, který podporuje aktualizaci, vázán na DetailsView ovládací prvek, DetailsView může ovládací prvek využívat možnosti správy zdrojů dat a poskytovat funkce automatické aktualizace.

Poznámka

Aby ovládací prvek zdroje dat aktualizoval data, musí být jeho SqlDataSource.UpdateCommand vlastnost nastavena příkazem aktualizačního dotazu.

Když je vlastnost nastavena AutoGenerateEditButton na true, CommandField pole řádku s tlačítkem Upravit se automaticky zobrazí v ovládacím DetailsView prvku. Kliknutím na tlačítko Upravit ovládací prvek umístíte DetailsView do režimu úprav. V režimu úprav zobrazí každé vázané pole v ovládacím prvku, které není jen pro čtení, příslušný vstupní ovládací prvek, například TextBox ovládací prvek, pro datový typ pole. To umožňuje uživateli upravit hodnotu pole.

Po kliknutí se tlačítko Upravit nahradí také tlačítkem Aktualizovat a tlačítkem Zrušit. Kliknutím na tlačítko Aktualizovat aktualizujete záznam ve zdroji dat libovolnými změnami hodnoty a vrátíte ovládací prvek do režimu určeného vlastností DefaultMode . Kliknutím na tlačítko Storno zrušíte všechny změny hodnoty a vrátíte ovládací prvek do výchozího režimu.

Poznámka

Pokud chcete ovládací prvek umístit DetailsView do režimu úprav prostřednictvím kódu programu, použijte metodu ChangeMode .

AutoGenerateRows Pokud je vlastnost nastavena také na true, ovládací prvek automaticky zajistí, DetailsView že pole nebo pole zadaná ve DataKeyNames vlastnosti jsou jen pro čtení.

Poznámka

Pokud neimplementujete vlastní funkce aktualizace, musíte nastavit DataKeyNames vlastnost, aby funkce automatické aktualizace fungovala.

Vzhled datových řádků můžete řídit, když DetailsView je ovládací prvek v režimu úprav pomocí EditRowStyle vlastnosti. Běžná nastavení obvykle zahrnují vlastní barvu pozadí, barvu popředí a vlastnosti písma.

Ovládací DetailsView prvek poskytuje několik událostí, které můžete použít k provedení vlastní akce při aktualizaci záznamu. Následující tabulka uvádí dostupné události.

Událost Description
ItemUpdated Nastane při kliknutí na tlačítko Aktualizovat, ale po ovládacím DetailsView prvku aktualizuje záznam. Tato událost se často používá ke kontrole výsledků operace aktualizace.
ItemUpdating Nastane při kliknutí na tlačítko Aktualizovat, ale před DetailsView ovládacím prvku aktualizuje záznam. Tato událost se často používá k zrušení operace aktualizace.
ModeChanged Dojde po DetailsView změně režimů ovládacího prvku.
ModeChanging Nastane před režimy DetailsView změn ovládacího prvku. Tato událost se často používá ke zrušení změny režimu.

Hodnota AutoGenerateEditButton je uložena ve stavu zobrazení.

Platí pro

Viz také