语言

GridView.AutoGenerateEditButton 属性

定义

获取或设置一个值,该值指示是否 CommandField 自动向控件添加包含每个数据行的“编辑”按钮的 GridView 字段列。

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

属性值

true 如果为每个数据行自动添加 CommandField 包含“编辑”按钮的字段列,则为 ;否则为 false。 默认值为 false。

示例

下面的示例演示如何使用 AutoGenerateEditButton 属性启用控件的 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>
<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>

注解

当支持更新的数据源控件绑定到控件 GridView 时,该 GridView 控件可以利用数据源控件的功能并提供自动更新功能。

注释

要使数据源控件更新数据,必须将其配置为更新数据。 若要配置数据源控件以更新记录,请参阅特定数据源控件的文档。

当属性设置为 /> 时,将自动向控件添加一个列(由对象表示),其中包含每个数据行的“编辑”按钮。 单击行的“编辑”按钮会将该行置于编辑模式。 当某一行处于编辑模式时,行中不只读的每个列字段都会显示字段数据类型的相应输入控件,例如 TextBox 控件。 这样,用户就可以修改字段的值。

单击后,“编辑”按钮也会替换为“更新”按钮和“取消”按钮。 单击“更新”按钮会用任何值更改更新数据源中的行,并返回要显示模式的行。 单击“取消”按钮将放弃任何值更改,并将行返回到显示模式。

注释

可以通过使用行的索引设置 EditIndex 属性,以编程方式将行置于编辑模式下。 若要以编程方式退出编辑模式,请将 EditIndex 属性设置为 -1。

使用内置更新功能时,必须使用逗号分隔的字段名称列表设置 DataKeyNames 属性,以标识数据源的主键字段或字段;否则,内置更新功能将无法更新正确的记录。 使用自动生成的字段列(通过将属性设置为AutoGenerateColumnstrue),控件GridView会自动确保与属性中指定的DataKeyNames字段或字段对应的自动生成的字段列是只读的。

可以使用该 EditRowStyle 属性控制处于编辑模式的行的外观。 常见设置通常包括自定义背景色、前景色和字体属性。

该 GridView 控件提供了多个事件,可用于在更新行时执行自定义操作。 下表列出了可用事件。

事件 Description
RowCancelingEdit 在单击行的“取消”按钮时发生,但在控件取消编辑模式之前 GridView 发生。 此事件通常用于停止取消操作。
RowEditing 当单击行的“编辑”按钮,但在控件进入编辑模式之前 GridView 发生。 此事件通常用于取消编辑操作。
RowUpdated 当单击行的“更新”按钮,但在控件更新行之后 GridView 发生。 此事件通常用于检查更新操作的结果。
RowUpdating 单击行的“更新”按钮,但在控件更新行之前 GridView 发生。 此事件通常用于取消更新操作。

适用于

另请参阅