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

각 데이터 행의 편집 단추가 있는 CommandField 필드 열을 자동으로 추가하려면 true이고, 그렇지 않으면 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 하여 자동으로 생성된 필드 열을 사용하는 경우 컨트롤은 속성 trueGridView 에 지정된 DataKeyNames 필드 또는 필드에 해당하는 자동으로 생성된 필드 열이 읽기 전용인지 자동으로 확인합니다.

속성을 사용하여 편집 모드에 있는 행의 모양을 제어할 EditRowStyle 수 있습니다. 일반적인 설정에는 일반적으로 사용자 지정 배경색, 전경색 및 글꼴 속성이 포함됩니다.

이 컨트롤은 GridView 행이 업데이트되면 사용자 지정 작업을 수행하는 데 사용할 수 있는 여러 이벤트를 제공합니다. 다음 표에서는 사용 가능한 이벤트를 나열합니다.

이벤트 설명
RowCancelingEdit 행의 취소 단추를 클릭할 때 컨트롤이 편집 모드에서 취소되기 전에 GridView 발생합니다. 이 이벤트는 취소 작업을 중지하는 데 자주 사용됩니다.
RowEditing 행의 편집 단추를 클릭하면 GridView 컨트롤이 편집 모드로 전환되기 전에 이 이벤트가 발생합니다. 이 이벤트는 편집 작업을 취소하는 데 자주 사용됩니다.
RowUpdated 행의 업데이트 단추를 클릭하면 GridView 컨트롤이 행을 업데이트한 후에 이 이벤트가 발생합니다. 이 이벤트는 업데이트 작업의 결과를 확인하는 데 자주 사용됩니다.
RowUpdating 행의 업데이트 단추를 클릭하면 GridView 컨트롤이 행을 업데이트하기 전에 이 이벤트가 발생합니다. 이 이벤트는 업데이트 작업을 취소하는 데 자주 사용됩니다.

적용 대상

추가 정보