Sdílet prostřednictvím

DetailsView.AutoGenerateEditButton Vlastnost

Definice

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

Získá nebo nastaví hodnotu urč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

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

Příklady

Následující příklad kódu ukazuje použití AutoGenerateEditButton vlastnosti k zobrazení předdefinovaných ovládacích prvků pro úpravu 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.

AutoGenerateEditButton Pokud je vlastnost nastavena na true, CommandField v ovládacím prvku se automaticky zobrazí DetailsView pole řádku s tlačítkem Upravit. Kliknutím na tlačítko Upravit umístíte tento DetailsView ovládací prvek do režimu úprav. V režimu úprav zobrazí každé vázané pole v ovládacím prvku, které není jen pro čtení, odpovídající vstupní ovládací prvek, například TextBox ovládací prvek, pro datový typ pole. To uživateli umožní 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 o jakékoli změně hodnoty a vrátíte ovládací prvek do režimu určeného DefaultMode vlastností. 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 vložit DetailsView do režimu úprav programově, použijte metodu ChangeMode .

AutoGenerateRows Pokud je vlastnost nastavena také truena , DetailsView ovládací prvek automaticky zajistí, ž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 řádků dat 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. V následující tabulce jsou uvedeny dostupné události.

Zvláštní 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 ovládacím DetailsView prvku aktualizuje záznam. Tato událost se často používá ke zrušení operace aktualizace.
ModeChanged Nastane po DetailsView režimu změn 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é