CommandField 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 바인딩된 컨트롤에서 선택, 편집, 삽입 또는 삭제 작업을 수행하는 명령 단추를 표시하는 특수 필드를 나타냅니다.
public ref class CommandField : System::Web::UI::WebControls::ButtonFieldBase
public class CommandField : System.Web.UI.WebControls.ButtonFieldBase
type CommandField = class
inherit ButtonFieldBase
Public Class CommandField
Inherits ButtonFieldBase
- 상속
예제
다음 코드 예제에서는 컨트롤에서 레코드 GridView 를 CommandField 편집 하는 컨트롤을 표시 하는 필드를 사용 하는 방법을 보여 줍니다.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:commandfield showeditbutton="true"
headertext="Edit Controls"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:commandfield showeditbutton="true"
headertext="Edit Controls"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
다음 코드 예제에서는 사용 하는 CancelText방법에 설명 합니다 . EditText및 UpdateText 속성을 편집 컨트롤에 대 한 텍스트를 사용자 지정 합니다.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:commandfield showeditbutton="true"
edittext="Edit Customer"
canceltext="Discard"
updatetext="Revise"
headertext="Edit Controls"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:commandfield showeditbutton="true"
edittext="Edit Customer"
canceltext="Discard"
updatetext="Revise"
headertext="Edit Controls"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
설명
이 CommandField 클래스는 삭제, 편집, 삽입 또는 선택 작업을 수행하는 명령 단추를 표시하기 위해 데이터 바인딩된 컨트롤(예: GridView 및 DetailsView)에서 사용하는 특수 필드입니다. 다음 표에 표시된 속성을 사용하여 이러한 작업을 수행하는 명령 단추를 표시하거나 숨길 수 있습니다.
| 재산 | 설명 |
|---|---|
| ShowDeleteButton | 데이터 바인딩된 컨트롤의 각 레코드에 CommandField 대한 필드에 삭제 단추를 표시하거나 숨깁니다. 삭제 단추를 사용하면 사용자가 데이터 원본에서 레코드를 삭제할 수 있습니다. |
| ShowEditButton | 데이터 바인딩된 컨트롤의 각 레코드에 CommandField 대한 필드에 편집 단추를 표시하거나 숨깁니다. 편집 단추를 사용하면 사용자가 데이터 원본에서 레코드를 편집할 수 있습니다. 사용자가 특정 레코드에 대한 편집 단추를 클릭하면 해당 편집 단추가 업데이트 단추와 취소 단추로 바뀝니다. 다른 모든 명령 단추도 숨겨집니다. |
| ShowInsertButton | 필드에 새로 만들기 단추를 CommandField 표시하거나 숨깁니다. 새 단추를 사용하면 사용자가 데이터 원본에 새 레코드를 삽입할 수 있습니다. 사용자가 새로 만들기 단추를 클릭하면 삽입 단추와 취소 단추로 바뀝니다. 다른 모든 명령 단추도 숨겨집니다. 참고: 이 속성은 컨트롤과 같은 삽입 작업을 지원하는 데이터 바인딩된 컨트롤에 DetailsView 만 적용됩니다. |
| ShowSelectButton | 데이터 바인딩된 컨트롤의 각 레코드에 CommandField 대한 필드에 선택 단추를 표시하거나 숨깁니다. 선택 단추를 사용하면 사용자가 데이터 바인딩된 컨트롤에서 레코드를 선택할 수 있습니다. |
또한 레코드가 편집 또는 삽입 모드에 있을 때 표시되는 취소 단추는 속성을 설정 ShowCancelButton 하여 표시하거나 숨길 수 있습니다.
메모
데이터 바인딩된 컨트롤을 데이터 소스 컨트롤(예: SqlDataSource 컨트롤)과 함께 사용하는 경우 데이터 바인딩된 컨트롤은 데이터 원본 컨트롤의 기능을 활용하고 자동 삭제, 업데이트 및 삽입 기능을 제공할 수 있습니다. 다른 데이터 원본의 경우 데이터 바인딩된 컨트롤에 대한 적절한 이벤트 중에 이러한 작업을 수행하는 루틴을 제공해야 합니다.
필드 CommandField 가 사용되는 데이터 바인딩된 컨트롤에 따라 다르게 표시됩니다. 예를 들어 컨트롤은 GridView 필드를 열로 표시 CommandField 하고 컨트롤은 DetailsView 필드를 행으로 표시합니다.
표시할 단추의 유형을 지정하려면 속성을 사용합니다 ButtonType .
ButtonType 속성을 설정 ButtonType.Button 하거나 ButtonType.Link다음 표에 표시된 속성을 설정하여 단추에 표시할 텍스트를 지정할 수 있습니다.
| 재산 | 설명 |
|---|---|
| CancelText | 취소 단추의 캡션입니다. |
| DeleteText | 삭제 단추의 캡션입니다. |
| EditText | 편집 단추의 캡션입니다. |
| InsertText | 삽입 단추의 캡션입니다. 참고: 이 속성은 컨트롤과 같은 삽입 작업을 지원하는 데이터 바인딩된 컨트롤에 DetailsView 만 적용됩니다. |
| NewText | 새로 만들기 단추의 캡션입니다. 참고: 이 속성은 컨트롤과 같은 삽입 작업을 지원하는 데이터 바인딩된 컨트롤에 DetailsView 만 적용됩니다. |
| SelectText | 선택 단추의 캡션입니다. |
| UpdateText | 업데이트 단추의 캡션입니다. |
명령 단추 또는 링크 단추를 표시하는 대신 속성을 다음 표에 표시된 속성으로 설정 ButtonType 하여 이미지 단추를 표시할 ButtonType.Image 수 있습니다.
| 재산 | 설명 |
|---|---|
| CancelImageUrl | 취소 단추에 대해 표시할 이미지 |
| DeleteImageUrl | 삭제 단추에 대해 표시할 이미지입니다. |
| EditImageUrl | 편집 단추에 대해 표시할 이미지입니다. |
| InsertText | 삽입 단추에 대해 표시할 이미지입니다. 참고: 이 속성은 컨트롤과 같은 삽입 작업을 지원하는 데이터 바인딩된 컨트롤에 DetailsView 만 적용됩니다. |
| NewImageUrl | 새로 만들기 단추에 대해 표시할 이미지입니다. 참고: 이 속성은 컨트롤과 같은 삽입 작업을 지원하는 데이터 바인딩된 컨트롤에 DetailsView 만 적용됩니다. |
| SelectImageUrl | 선택 단추에 대해 표시할 이미지입니다. |
| UpdateImageUrl | 업데이트 단추에 대해 표시할 이미지입니다. |
기본적으로 사용자가 필드에서 단추를 CommandField 클릭하면 페이지의 모든 유효성 검사 컨트롤에서 유효성 검사가 수행됩니다. 단추를 클릭할 때 유효성 검사가 발생하지 않도록 하려면 속성을 false.로 설정합니다CausesValidation.
속성을 false.로 CommandField 설정하여 데이터 바인딩된 컨트롤의 Visible 필드를 숨길 수 있습니다.
필드를 CommandField 사용하면 머리글 및 바닥글 섹션을 사용자 지정할 수 있습니다. 머리글 또는 바닥글 섹션에 캡션을 표시하려면 각각 또는 속성을 설정합니다 HeaderTextFooterText . 머리글 섹션에 텍스트를 표시하는 대신 속성을 설정하여 이미지를 표시할 HeaderImageUrl 수 있습니다. 개체에서 헤더 섹션을 CommandField 숨기려면 속성을 false.로 설정합니다ShowHeader.
메모
일부 데이터 바인딩된 컨트롤(예: GridView 컨트롤)은 컨트롤의 전체 헤더 섹션만 표시하거나 숨길 수 있습니다. 이러한 데이터 바인딩된 컨트롤은 개별 단추 필드에 대한 속성을 지원하지 ShowHeader 않습니다. 데이터 바인딩된 컨트롤의 전체 헤더 섹션을 표시하거나 숨기려면(사용 가능한 경우) 컨트롤의 ShowHeader 속성을 사용합니다.
필드의 여러 부분에 대한 스타일 속성을 설정하여 개체의 CommandField 모양(글꼴 색, 배경색 등)을 사용자 지정할 수도 있습니다. 다음 표에서는 다양한 스타일 속성을 나열합니다.
| Style 속성 | 설명 |
|---|---|
| ControlStyle | 개체의 자식 웹 서버 컨트롤에 CommandField 대한 스타일 설정입니다. |
| FooterStyle | 개체의 바닥글 구역 CommandField 에 대한 스타일 설정입니다. |
| HeaderStyle | 개체의 머리글 섹션에 대한 스타일 설정입니다 CommandField . |
| ItemStyle | 개체의 데이터 항목에 대한 스타일 설정입니다 CommandField . |
생성자
| Name | Description |
|---|---|
| CommandField() |
CommandField 클래스의 새 인스턴스를 초기화합니다. |
속성
| Name | Description |
|---|---|
| AccessibleHeaderText |
일부 컨트롤에서 속성 값으로 |
| ButtonType |
단추 필드에 표시할 단추 유형을 가져오거나 설정합니다. (다음에서 상속됨 ButtonFieldBase) |
| CancelImageUrl |
필드의 취소 단추에 대해 표시할 이미지의 URL을 CommandField 가져오거나 설정합니다. |
| CancelText |
필드에 표시되는 취소 단추의 캡션을 CommandField 가져오거나 설정합니다. |
| CausesValidation |
사용자가 필드에서 단추를 CommandField 클릭할 때 유효성 검사가 수행되는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| Control |
개체가 연결된 데이터 컨트롤에 DataControlField 대한 참조를 가져옵니다. (다음에서 상속됨 DataControlField) |
| ControlStyle |
개체에 포함된 DataControlField 웹 서버 컨트롤의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField) |
| DeleteImageUrl |
필드의 삭제 단추에 대해 표시할 이미지의 URL을 CommandField 가져오거나 설정합니다. |
| DeleteText |
필드의 삭제 단추 CommandField 에 대한 캡션을 가져오거나 설정합니다. |
| DesignMode |
데이터 제어 필드가 현재 디자인 타임 환경에서 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
| EditImageUrl |
필드의 편집 단추에 대해 표시할 이미지의 URL을 CommandField 가져오거나 설정합니다. |
| EditText |
필드에서 편집 단추 CommandField 의 캡션을 가져오거나 설정합니다. |
| FooterStyle |
데이터 컨트롤 필드 바닥글의 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| FooterText |
데이터 컨트롤 필드의 바닥글 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| HeaderImageUrl |
데이터 제어 필드의 헤더 항목에 표시되는 이미지의 URL을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| HeaderStyle |
데이터 컨트롤 필드의 머리글 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| HeaderText |
데이터 컨트롤 필드의 헤더 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| InsertImageUrl |
필드의 삽입 단추에 대해 표시할 이미지의 URL을 CommandField 가져오거나 설정합니다. |
| InsertText |
필드의 삽입 단추에 대한 캡션을 CommandField 가져오거나 설정합니다. |
| InsertVisible |
부모 데이터 바인딩된 컨트롤이 삽입 모드에 DataControlField 있을 때 개체가 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
| IsTrackingViewState |
개체가 뷰 상태에 대한 변경 내용을 저장하고 있는지 여부를 DataControlField 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
| ItemStyle |
데이터 제어 필드에 표시되는 텍스트 기반 콘텐츠의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField) |
| NewImageUrl |
필드의 새로 만들기 단추에 대해 표시할 이미지의 URL을 CommandField 가져오거나 설정합니다. |
| NewText |
필드에서 새로 만들기 단추의 캡션을 CommandField 가져오거나 설정합니다. |
| SelectImageUrl |
필드의 선택 단추에 대해 표시할 이미지의 URL을 CommandField 가져오거나 설정합니다. |
| SelectText |
필드에서 선택 단추 CommandField 의 캡션을 가져오거나 설정합니다. |
| ShowCancelButton |
취소 단추가 필드에 표시되는 CommandField 지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ShowDeleteButton |
삭제 단추가 필드에 표시되는 CommandField 지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ShowEditButton |
편집 단추가 필드에 표시되는 CommandField 지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ShowHeader |
머리글 섹션이 개체에 표시되는 ButtonFieldBase 지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 ButtonFieldBase) |
| ShowInsertButton |
필드에 새로 만들기 단추가 표시되는 CommandField 지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ShowSelectButton |
선택 단추가 필드에 표시되는 CommandField 지 여부를 나타내는 값을 가져오거나 설정합니다. |
| SortExpression |
데이터 원본 컨트롤에서 데이터를 정렬하는 데 사용되는 정렬 식을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| UpdateImageUrl |
필드의 업데이트 단추에 대해 표시할 이미지의 URL을 CommandField 가져오거나 설정합니다. |
| UpdateText |
필드에서 업데이트 단추의 캡션을 CommandField 가져오거나 설정합니다. |
| ValidateRequestMode |
컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| ValidationGroup |
개체의 단추를 ButtonFieldBase 클릭할 때 유효성을 검사할 유효성 검사 컨트롤 그룹의 이름을 가져오거나 설정합니다. (다음에서 상속됨 ButtonFieldBase) |
| ViewState |
동일한 페이지에 대한 여러 요청에서 개체의 DataControlField 뷰 상태를 저장하고 복원할 수 있는 상태 정보 사전을 가져옵니다. (다음에서 상속됨 DataControlField) |
| Visible |
데이터 제어 필드가 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
메서드
명시적 인터페이스 구현
| Name | Description |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
이 DataControlField 개체와 연결된 스키마를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
| IStateManager.IsTrackingViewState |
개체가 뷰 상태에 대한 변경 내용을 저장하고 있는지 여부를 DataControlField 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
| IStateManager.LoadViewState(Object) |
데이터 제어 필드의 이전에 저장된 뷰 상태를 복원합니다. (다음에서 상속됨 DataControlField) |
| IStateManager.SaveViewState() |
페이지가 서버에 다시 게시된 이후의 보기 상태에 대한 변경 내용을 DataControlField 저장합니다. (다음에서 상속됨 DataControlField) |
| IStateManager.TrackViewState() |
개체가 DataControlField 해당 뷰 상태의 변경 내용을 추적하여 컨트롤의 ViewState 속성에 저장하고 동일한 페이지에 대한 요청 간에 유지할 수 있도록 합니다. (다음에서 상속됨 DataControlField) |
적용 대상
추가 정보
- GridView
- Columns
- DetailsView
- Fields
- BoundField
- ButtonField
- ButtonFieldBase
- CheckBoxField
- DataControlField
- HyperLinkField
- TemplateField
- ButtonType
- CancelText
- DeleteImageUrl
- DeleteText
- EditImageUrl
- EditText
- InsertImageUrl
- InsertText
- NewImageUrl
- NewText
- SelectImageUrl
- SelectText
- ShowCancelButton
- ShowDeleteButton
- ShowEditButton
- ShowInsertButton
- ShowSelectButton
- UpdateImageUrl
- UpdateText
- ControlStyle
- FooterStyle
- HeaderStyle
- ItemStyle