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
- 상속
예제
다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 CommandField 의 레코드를 편집 하는 컨트롤에 표시할 필드를 GridView 제어 합니다.
<%@ 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 필드, 페이지의 모든 유효성 검사 컨트롤에 유효성 검사를 수행 합니다. 단추를 클릭할 때 유효성 검사가 수행을 방지 하려면 설정 합니다 CausesValidation 속성을 false
입니다.
숨길 수 있습니다는 CommandField 설정 하 여 데이터 바인딩된 컨트롤의 필드를 Visible 속성을 false
입니다.
CommandField 필드를 사용 하면 머리글 및 바닥글 구역을 사용자 지정할 수 있습니다. 캡션을 머리글 또는 바닥글 구역에 표시할 설정 합니다 HeaderText 또는 FooterText 속성을 각각. 헤더 섹션에 텍스트를 표시 하는 대신 설정 하 여 이미지를 표시할 수는 HeaderImageUrl 속성입니다. 헤더 섹션을 숨기려면를 CommandField 개체, 설정 된 ShowHeader 속성을 false
입니다.
참고
일부 데이터 바인딩된 컨트롤 (같은 GridView 컨트롤) 표시 하거나 컨트롤의 전체 헤더 섹션을 숨길 수 있습니다. 이러한 데이터 바인딩된 컨트롤을 지원 하지 않습니다는 ShowHeader 는 개별 단추 필드에 대 한 속성입니다. 표시 하거나 (가능한 경우) 데이터 바인딩된 컨트롤의 전체 헤더 섹션을 숨기 거 나 컨트롤을 사용 하 여 ShowHeader
속성입니다.
또한 사용자 지정할 수 있습니다 모양의 CommandField 필드의 다른 부분에 대 한 스타일 속성을 설정 하 여 개체 (글꼴 색, 배경색 및 등). 다음 표에서 다양 한 스타일 속성을 나열합니다.
스타일 속성 | Description |
---|---|
ControlStyle | 자식 웹 서버 컨트롤에 대 한 스타일 설정을 CommandField 개체입니다. |
FooterStyle | 바닥글 구역에 대 한 스타일 설정을 CommandField 개체입니다. |
HeaderStyle | 머리글 구역에 대 한 스타일 설정을 CommandField 개체입니다. |
ItemStyle | 데이터 항목에 대 한 스타일 설정이 CommandField 개체입니다. |
생성자
CommandField() |
CommandField 클래스의 새 인스턴스를 초기화합니다. |
속성
AccessibleHeaderText |
일부 컨트롤에서 |
ButtonType |
단추 필드에 표시할 단추 형식을 가져오거나 설정합니다. (다음에서 상속됨 ButtonFieldBase) |
CancelImageUrl |
CommandField 필드의 취소 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다. |
CancelText |
CommandField 필드에 표시될 취소 단추의 캡션을 가져오거나 설정합니다. |
CausesValidation |
사용자가 CommandField 필드에 있는 단추를 클릭할 때 유효성 검사를 수행할지 여부를 나타내는 값을 가져오거나 설정합니다. |
Control |
DataControlField 개체가 연결된 데이터 컨트롤에 대한 참조를 가져옵니다. (다음에서 상속됨 DataControlField) |
ControlStyle |
DataControlField 개체에 포함된 웹 서버 컨트롤의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField) |
DeleteImageUrl |
CommandField 필드의 삭제 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다. |
DeleteText |
CommandField 필드에 있는 삭제 단추의 캡션을 가져오거나 설정합니다. |
DesignMode |
데이터 컨트롤 필드가 현재 디자인 타임 환경에서 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
EditImageUrl |
CommandField 필드의 편집 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다. |
EditText |
CommandField 필드에 있는 편집 단추의 캡션을 가져오거나 설정합니다. |
FooterStyle |
데이터 컨트롤 필드의 바닥글 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
FooterText |
데이터 컨트롤 필드의 바닥글 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
HeaderImageUrl |
데이터 컨트롤 필드의 머리글 항목에 표시되는 이미지의 URL을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
HeaderStyle |
데이터 컨트롤 필드의 머리글 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
HeaderText |
데이터 컨트롤 필드의 머리글 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
InsertImageUrl |
CommandField 필드의 삽입 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다. |
InsertText |
CommandField 필드에 있는 삽입 단추의 캡션을 가져오거나 설정합니다. |
InsertVisible |
데이터 바인딩된 부모 컨트롤이 삽입 모드에 있는 경우 DataControlField 개체가 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
IsTrackingViewState |
DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField) |
ItemStyle |
데이터 컨트롤 필드에 표시되는 텍스트 기반 내용의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField) |
NewImageUrl |
CommandField 필드의 새로 만들기 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다. |
NewText |
CommandField 필드에 있는 새로 만들기 단추의 캡션을 가져오거나 설정합니다. |
SelectImageUrl |
CommandField 필드의 새로 만들기 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다. |
SelectText |
CommandField 필드에 있는 선택 단추의 캡션을 가져오거나 설정합니다. |
ShowCancelButton |
CommandField 필드에 취소 단추를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. |
ShowDeleteButton |
CommandField 필드에 삭제 단추를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. |
ShowEditButton |
CommandField 필드에 편집 단추를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. |
ShowHeader |
ButtonFieldBase 개체에 머리글 구역을 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 ButtonFieldBase) |
ShowInsertButton |
CommandField 필드에 새로 만들기 단추를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. |
ShowSelectButton |
CommandField 필드에 선택 단추를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. |
SortExpression |
데이터 소스 컨트롤에서 데이터를 정렬하는 데 사용되는 정렬 식을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
UpdateImageUrl |
CommandField 필드의 업데이트 단추에 대해 표시할 이미지의 URL을 가져오거나 설정합니다. |
UpdateText |
CommandField 필드에 있는 업데이트 단추의 캡션을 가져오거나 설정합니다. |
ValidateRequestMode |
컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
ValidationGroup |
ButtonFieldBase 개체의 단추를 클릭할 때 유효성 검사를 수행할 유효성 검사 컨트롤 그룹의 이름을 가져오거나 설정합니다. (다음에서 상속됨 ButtonFieldBase) |
ViewState |
같은 페이지에 대한 여러 개의 요청 전반에 DataControlField 개체의 뷰 상태를 저장하고 복원하는 데 사용할 수 있는 상태 정보 사전을 가져옵니다. (다음에서 상속됨 DataControlField) |
Visible |
데이터 컨트롤 필드가 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField) |
메서드
명시적 인터페이스 구현
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