GridView.AutoGenerateEditButton Свойство

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

Возвращает или задает значение, указывающее, добавляется ли 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

Значение свойства

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 элемент управления может воспользоваться возможностями системы управления версиями данных и обеспечить функции автоматического обновления.

Замечание

Чтобы элемент управления источниками данных обновлял данные, его необходимо настроить для обновления данных. Сведения о настройке системы управления источниками данных для обновления записей см. в документации по конкретному элементу управления версиями данных.

AutoGenerateEditButton Если для свойства задано trueзначение, столбец (представленный CommandField объектом) с кнопкой "Изменить" для каждой строки данных автоматически добавляется в GridView элемент управления. Нажатие кнопки "Изменить" для строки помещает ее в режим редактирования. Если строка находится в режиме редактирования, каждое поле столбца в строке, которая не доступна только для чтения, отображает соответствующий TextBox входной элемент управления, например элемент управления, для типа данных поля. Это позволяет пользователю изменять значение поля.

При нажатии кнопки "Изменить" также заменяется кнопкой "Обновить" и кнопкой "Отмена". Нажатие кнопки "Обновить" обновляет строку в источнике данных с любым изменением значения и возвращает строку для отображения в режиме отображения. Нажатие кнопки "Отмена" отменяет любые изменения значений и возвращает строку для отображения режима.

Замечание

Вы можете программно поместить строку в режим редактирования, задав EditIndex свойство с индексом строки. Чтобы программным способом выйти из режима редактирования, задайте EditIndex для свойства значение -1.

При использовании встроенной функции обновления необходимо задать DataKeyNames свойство с разделенным запятыми списком имен полей, чтобы определить поле первичного ключа или поля источника данных. В противном случае встроенная функция обновления не сможет обновить правильную запись. При использовании автоматически созданных столбцов полей (задав AutoGenerateColumns для свойства trueзначение ), GridView элемент управления автоматически гарантирует, что автоматически созданные столбцы полей, соответствующие полю или полям, указанным в DataKeyNames свойстве, доступны только для чтения.

Внешний вид строки, которая находится в режиме редактирования, можно управлять с помощью EditRowStyle свойства. Общие параметры обычно включают настраиваемый цвет фона, цвет переднего плана и свойства шрифта.

Элемент GridView управления предоставляет несколько событий, которые можно использовать для выполнения пользовательского действия при обновлении строки. В следующей таблице перечислены доступные события.

Event	Описание
RowCancelingEdit	Происходит при нажатии кнопки "Отмена" строки, но перед GridView отменой элемента управления в режиме редактирования. Это событие часто используется для остановки операции отмены.
RowEditing	Происходит при нажатии кнопки "Изменить" строки, но перед GridView вводом элемента управления в режим редактирования. Это событие часто используется для отмены операции редактирования.
RowUpdated	Происходит при нажатии кнопки "Обновить" строки, но после GridView обновления строки элементом управления. Это событие часто используется для проверки результатов операции обновления.
RowUpdating	Происходит при нажатии кнопки "Обновить строку", но перед обновлением GridView строки элементом управления. Это событие часто используется для отмены операции обновления.

См. также раздел

• CommandField
• AutoGenerateDeleteButton
• AutoGenerateSelectButton
• AutoGenerateColumns
• DataKeys
• DataKeyNames
• EditIndex
• EditRowStyle
• RowCancelingEdit
• RowEditing
• RowUpdated
• RowUpdating