Sdílet prostřednictvím

GridView.AutoGenerateEditButton Vlastnost

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 tlačítkem Upravit pro každý datový řádek 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

truepro automatické přidání CommandField sloupce pole s tlačítkem Upravit pro každý řádek dat, jinak . false Výchozí hodnota je false.

Příklady

Následující příklad ukazuje, jak pomocí AutoGenerateEditButton vlastnosti povolit automatickou úpravu GridView funkce 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 aktualizaci, vázán na GridView ovládací prvek, GridView 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 nakonfigurovaný tak, aby aktualizoval data. Pokud chcete nakonfigurovat ovládací prvek zdroje dat pro aktualizaci záznamů, přečtěte si dokumentaci ke konkrétní správě zdroje dat.

Pokud je vlastnost nastavena AutoGenerateEditButton na true, sloupec (reprezentovaný objektem CommandField ) 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 pro řádek umístíte tento řádek do režimu úprav. Pokud je řádek v režimu úprav, každé pole sloupce v řádku, které není jen pro čtení, zobrazí příslušný 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 řádek ve zdroji dat o všechny změny hodnoty a vrátíte řádek do režimu zobrazení. Kliknutím na tlačítko Storno zrušíte všechny změny hodnoty a vrátíte řádek do režimu zobrazení.

Poznámka:

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

Při použití předdefinované funkce aktualizace je nutné nastavit DataKeyNames vlastnost se seznamem polí oddělených čárkami, aby bylo možné identifikovat pole primárního klíče nebo pole zdroje dat. Jinak předdefinované funkce aktualizace nebudou moct aktualizovat správný záznam. Při použití automaticky generovaných sloupců polí (nastavením AutoGenerateColumns vlastnosti na true), GridView ovládací prvek automaticky zajistí, že automaticky generované sloupce pole, 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. Běžná nastavení obvykle zahrnují vlastní barvu pozadí, barvu 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. V následující tabulce jsou uvedeny dostupné události.

Zvláštní událost Description
RowCancelingEdit Nastane při kliknutí na tlačítko Storno řádku, ale před GridView zrušením 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 řádku, ale před přechodem GridView ovládacího prvku do režimu úprav. Tato událost se často používá ke zrušení operace úprav.
RowUpdated Nastane při kliknutí na tlačítko Aktualizovat řádek, ale po GridView aktualizaci ovládacího prvku řádek. Tato událost se často používá ke kontrole výsledků operace aktualizace.
RowUpdating Nastane, když se klikne na tlačítko Aktualizovat řádek, ale před tím, než GridView ovládací prvek aktualizuje řádek. Tato událost se často používá ke zrušení operace aktualizace.

Platí pro

Viz také