GridView.AutoGenerateEditButton Vlastnost

  • Reference

Definice

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

Získá nebo nastaví hodnotu určující, zda CommandField sloupec pole s upravit tlačítko pro každý řádek dat je automaticky přidán do GridView ovládacího 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 automatickému CommandField přidání sloupce pole s tlačítkem Upravit pro každý řádek dat. falseV opačném případě . Výchozí formát je false.

Příklady

Následující příklad ukazuje, jak použít AutoGenerateEditButton vlastnost k povolení funkce automatických GridView úprav ovládacího prvku.

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

Poznámky

Pokud je ovládací prvek zdroje dat, který podporuje aktualizace, vázán na GridView ovládací prvek, GridView může tento ovládací prvek využívat možnosti ovládacího prvku zdroje dat a poskytovat funkce automatických aktualizací.

Poznámka

Aby ovládací prvek zdroje dat aktualizoval data, musí být nakonfigurovaný tak, aby aktualizoval data. Informace o konfiguraci ovládacího prvku zdroje dat pro aktualizaci záznamů najdete v dokumentaci ke konkrétnímu ovládacímu prvku zdroje dat.

AutoGenerateEditButton Když je vlastnost nastavena na true, sloupec (reprezentovaný objektemCommandField) s tlačítkem Upravit pro každý řádek dat se automaticky přidá do GridView ovládacího prvku. Kliknutím na tlačítko Upravit u řádku se tento řádek přemísťuje do režimu úprav. Pokud je řádek v režimu úprav, zobrazí každé sloupcové pole v řádku, které není jen pro čtení, příslušný vstupní ovládací prvek, například TextBox ovládací prvek, pro datový typ pole. To uživateli umožňuje upravit hodnotu pole.

Po kliknutí se tlačítko Upravit také nahradí tlačítkem Aktualizovat a zrušit. Kliknutím na tlačítko Aktualizovat aktualizujete řádek ve zdroji dat o všechny změny hodnot a vrátíte řádek do režimu zobrazení. Kliknutím na tlačítko Zrušit zrušíte všechny změny hodnot a vrátíte řádek do režimu zobrazení.

Poznámka

Řádek můžete do režimu úprav umístit programově nastavením EditIndex vlastnosti s indexem řádku. Pokud chcete režim úprav programově ukončit, nastavte EditIndex vlastnost na -1.

Pokud používáte předdefinovanou funkci aktualizace, musíte nastavit DataKeyNames vlastnost se seznamem názvů polí odděleným čárkami, abyste identifikovali pole primárního klíče nebo pole zdroje dat. Jinak integrovaná funkce aktualizace nebude moct aktualizovat správný záznam. Při použití automaticky vygenerovaných sloupců polí (nastavením AutoGenerateColumns vlastnosti na true), GridView ovládací prvek automaticky zajistí, že automaticky generované sloupce polí, které odpovídají poli nebo polím zadaným ve DataKeyNames vlastnosti, jsou jen pro čtení.

Vzhled řádku, který je v režimu úprav, můžete řídit pomocí EditRowStyle vlastnosti . Mezi běžná nastavení obvykle patří vlastní barva pozadí, barva popředí a vlastnosti písma.

Ovládací GridView prvek poskytuje několik událostí, které můžete použít k provedení vlastní akce při aktualizaci řádku. Následující tabulka obsahuje seznam dostupných událostí.

Událost Description
RowCancelingEdit Nastane při kliknutí na tlačítko Zrušit na řádku, ale před zrušením GridView ovládacího prvku mimo režim úprav. Tato událost se často používá k zastavení operace zrušení.
RowEditing Nastane při kliknutí na tlačítko Upravit na řádku, ale před tím, než GridView ovládací prvek přejde do režimu úprav. Tato událost se často používá ke zrušení operace úprav.
RowUpdated Nastane, když se klikne na tlačítko Aktualizovat na řádku, ale poté, co GridView ovládací prvek řádek aktualizuje. Tato událost se často používá ke kontrole výsledků operace aktualizace.
RowUpdating Nastane při kliknutí na tlačítko Aktualizovat na řádku, ale před tím, než GridView ovládací prvek řádek aktualizuje. Tato událost se často používá ke zrušení operace aktualizace.

Platí pro

Viz také