ButtonField 클래스

정의

데이터 바인딩된 컨트롤에서 단추로 표시되는 필드를 나타냅니다.

public ref class ButtonField : System::Web::UI::WebControls::ButtonFieldBase
public class ButtonField : System.Web.UI.WebControls.ButtonFieldBase
type ButtonField = class
    inherit ButtonFieldBase
Public Class ButtonField
Inherits ButtonFieldBase
상속

예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 ButtonField 열에 명령 단추에 표시할 개체를 GridView 컨트롤입니다.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
  
    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {
    
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    
    
      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + contact + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          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">
<script runat="server">

    Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
        ' If multiple ButtonField column fields are used, use the
        ' CommandName property to determine which button was clicked.
        If e.CommandName = "Select" Then
    
            ' Convert the row index stored in the CommandArgument
            ' property to an Integer.
            Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
            ' Get the last name of the selected author from the appropriate
            ' cell in the GridView control.
            Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
            Dim contactCell As TableCell = selectedRow.Cells(1)
            Dim contact As String = contactCell.Text
    
            ' Display the selected author.
            Message.Text = "You selected " & contact & "."
      
        End If
    
    End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>

설명

합니다 ButtonField 클래스는 데이터 바인딩된 컨트롤에서 사용 됩니다 (같은 GridViewDetailsView) 표시 되는 각 레코드에 대 한 단추를 표시 하려면. ButtonField 개체가 사용 되는 데이터 바인딩된 컨트롤에 따라 다르게 표시 됩니다. 예를 들어 합니다 GridView 컨트롤이 표시를 ButtonField 열을 개체로 하는 동안를 DetailsView 컨트롤 행으로 표시 합니다.

단추 필드에 단추를 클릭 하면 부모 데이터 바인딩된 컨트롤의 명령 이벤트를 발생 시킵니다. 명령 이벤트에 대 한 이벤트 처리기를 제공 하 여 명령 단추를 클릭할 때 수행 하는 사용자 지정 루틴을 제공할 수 있습니다.

참고

GridView 를 발생 시킵니다를 RowCommand 이벤트 동안 합니다 DetailsView 를 발생 시킵니다를 ItemCommand 이벤트.

명령 이벤트가 발생 하는 레코드의 인덱스를 확인 하려면 사용 된 CommandArgument 데이터 바인딩된 컨트롤에 대 한 명령 이벤트에 전달 되는 이벤트 인수의 속성입니다. ButtonField 클래스를 자동으로 채우려고는 CommandArgument 적절 한 인덱스 값을 가진 속성입니다.

표시할 단추의 종류를 지정 하려면 사용 된 ButtonType 속성입니다. 링크 또는 명령 단추를 표시할 때 사용 된 Text 단추에 표시할 캡션을 지정 하는 속성입니다.

참고

설정 하는 경우는 Text 속성에서 모든 단추에는 ButtonField 같은 캡션이 있습니다.

바인딩할 수 있습니다는 ButtonField 개체 데이터 소스의 필드입니다. 이렇게 하면 서로 다른 캡션을 단추에 표시할 수 있습니다는 ButtonField 개체입니다. 지정된 된 필드에 있는 값은 단추의 텍스트 캡션을에 사용 됩니다. 설정 합니다 DataTextField 바인딩할 속성을 ButtonField 개체 데이터 소스의 필드.

이미지 단추를 표시할 때 사용 합니다 ImageUrl 단추에 표시할 이미지를 지정 하는 속성을 ButtonField 개체입니다.

참고

모든 단추에는 ButtonField 동일한 이미지를 공유 하는 개체입니다.

숨길 수 있습니다는 ButtonField 설정 하 여 데이터 바인딩된 컨트롤에 개체를 Visible 속성을 false입니다.

ButtonField 개체를 사용 하면 머리글 및 바닥글 구역을 사용자 지정할 수 있습니다. 캡션을 머리글 또는 바닥글 구역에 표시할 설정 합니다 HeaderText 또는 FooterText 속성을 각각. 헤더 섹션에 텍스트를 표시 하는 대신 설정 하 여 이미지를 표시할 수는 HeaderImageUrl 속성입니다. 헤더 섹션을 숨기려면를 ButtonField 개체, 설정 된 ShowHeader 속성을 false입니다.

참고

일부 데이터 바인딩된 컨트롤 (같은 GridView 컨트롤) 표시 하거나 컨트롤의 전체 헤더 섹션을 숨길 수 있습니다. 이러한 데이터 바인딩된 컨트롤을 지원 하지 않습니다는 ShowHeader 는 개별 단추 필드에 대 한 속성입니다. 표시 하거나 (가능한 경우)에 데이터 바인딩된 컨트롤의 전체 헤더 섹션을 숨기 거 나 사용을 ShowHeader 컨트롤의 속성입니다.

또한 사용자 지정할 수 있습니다 모양의 ButtonField 필드의 다른 부분에 대 한 스타일 속성을 설정 하 여 개체 (글꼴 색, 배경색 및 등). 다음 표에서 다양 한 스타일 속성을 나열합니다.

스타일 속성 스타일 설정
ControlStyle 자식 웹 서버 컨트롤은 ButtonField합니다.
FooterStyle 바닥글 구역을 여 ButtonField입니다.
HeaderStyle 머리글 구역을 여 ButtonField입니다.
ItemStyle 데이터 항목에 ButtonField합니다.

생성자

ButtonField()

ButtonField 클래스의 새 인스턴스를 초기화합니다.

속성

AccessibleHeaderText

일부 컨트롤에서 AbbreviatedText 속성 값으로 렌더링되는 텍스트를 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
ButtonType

단추 필드에 표시할 단추 형식을 가져오거나 설정합니다.

(다음에서 상속됨 ButtonFieldBase)
CausesValidation

ButtonFieldBase 개체의 단추를 클릭한 경우 유효성 검사를 수행할지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 ButtonFieldBase)
CommandName

ButtonField 개체의 단추를 클릭할 때 수행할 작업을 나타내는 문자열을 가져오거나 설정합니다.

Control

DataControlField 개체가 연결된 데이터 컨트롤에 대한 참조를 가져옵니다.

(다음에서 상속됨 DataControlField)
ControlStyle

DataControlField 개체에 포함된 웹 서버 컨트롤의 스타일을 가져옵니다.

(다음에서 상속됨 DataControlField)
DataTextField

Text 개체에서 렌더링되는 Button 컨트롤의 ButtonField 속성에 값이 바인딩될 데이터 필드의 이름을 가져오거나 설정합니다.

DataTextFormatString

필드 값의 표시 형식을 지정하는 문자열을 가져오거나 설정합니다.

DesignMode

데이터 컨트롤 필드가 현재 디자인 타임 환경에서 표시되는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
FooterStyle

데이터 컨트롤 필드의 바닥글 스타일을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
FooterText

데이터 컨트롤 필드의 바닥글 항목에 표시되는 텍스트를 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
HeaderImageUrl

데이터 컨트롤 필드의 머리글 항목에 표시되는 이미지의 URL을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
HeaderStyle

데이터 컨트롤 필드의 머리글 스타일을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
HeaderText

데이터 컨트롤 필드의 머리글 항목에 표시되는 텍스트를 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
ImageUrl

ButtonField 개체의 각 단추에 표시할 이미지를 가져오거나 설정합니다.

InsertVisible

데이터 바인딩된 부모 컨트롤이 삽입 모드에 있는 경우 DataControlField 개체가 표시되는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
IsTrackingViewState

DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
ItemStyle

데이터 컨트롤 필드에 표시되는 텍스트 기반 내용의 스타일을 가져옵니다.

(다음에서 상속됨 DataControlField)
ShowHeader

ButtonFieldBase 개체에 머리글 구역을 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 ButtonFieldBase)
SortExpression

데이터 소스 컨트롤에서 데이터를 정렬하는 데 사용되는 정렬 식을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
Text

ButtonField 개체의 각 단추에 표시되는 정적 캡션을 가져오거나 설정합니다.

ValidateRequestMode

컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
ValidationGroup

ButtonFieldBase 개체의 단추를 클릭할 때 유효성 검사를 수행할 유효성 검사 컨트롤 그룹의 이름을 가져오거나 설정합니다.

(다음에서 상속됨 ButtonFieldBase)
ViewState

같은 페이지에 대한 여러 개의 요청 전반에 DataControlField 개체의 뷰 상태를 저장하고 복원하는 데 사용할 수 있는 상태 정보 사전을 가져옵니다.

(다음에서 상속됨 DataControlField)
Visible

데이터 컨트롤 필드가 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)

메서드

CloneField()

현재 DataControlField에서 파생된 개체의 복사본을 만듭니다.

(다음에서 상속됨 DataControlField)
CopyProperties(DataControlField)

현재 ButtonField 개체의 속성을 지정된 DataControlField 개체로 복사합니다.

CreateField()

ButtonField 클래스의 새 인스턴스를 만들어 반환합니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

현재 표 셀에서 데이터 컨트롤 필드의 값을 추출하여 지정된 IDictionary 컬렉션에 추가합니다.

(다음에서 상속됨 DataControlField)
FormatDataTextValue(Object)

ButtonField 개체의 셀에 대해 지정된 필드 값의 형식을 지정합니다.

GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
Initialize(Boolean, Control)

현재 ButtonField 개체를 초기화합니다.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

지정된 DataControlFieldCell 개체를 지정된 행 상태로 초기화합니다.

LoadViewState(Object)

데이터 소스 뷰를 이전에 저장된 뷰 상태로 복원합니다.

(다음에서 상속됨 DataControlField)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
OnFieldChanged()

FieldChanged 이벤트를 발생시킵니다.

(다음에서 상속됨 DataControlField)
SaveViewState()

페이지가 서버에 포스트백된 이후의 DataControlField 뷰 상태 변경 내용을 저장합니다.

(다음에서 상속됨 DataControlField)
ToString()

DataControlField 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 DataControlField)
TrackViewState()

DataControlField 개체가 뷰 상태의 변경 내용을 추적하도록 합니다. 이렇게 하면 해당 뷰 상태의 변경 내용을 컨트롤의 ViewState 속성에 저장하여 같은 페이지에 대한 여러 요청에서 일관되게 유지할 수 있습니다.

(다음에서 상속됨 DataControlField)
ValidateSupportsCallback()

ButtonField 개체에 들어 있는 컨트롤에서 콜백이 지원되는지 여부를 확인합니다.

명시적 인터페이스 구현

IDataSourceViewSchemaAccessor.DataSourceViewSchema

DataControlField 개체에 연결된 스키마를 가져오거나 설정합니다.

(다음에서 상속됨 DataControlField)
IStateManager.IsTrackingViewState

DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DataControlField)
IStateManager.LoadViewState(Object)

데이터 컨트롤 필드를 이전에 저장된 뷰 상태로 복원합니다.

(다음에서 상속됨 DataControlField)
IStateManager.SaveViewState()

페이지가 서버에 포스트백된 이후의 DataControlField 뷰 상태 변경 내용을 저장합니다.

(다음에서 상속됨 DataControlField)
IStateManager.TrackViewState()

DataControlField 개체가 뷰 상태의 변경 내용을 추적하도록 합니다. 이렇게 하면 해당 뷰 상태의 변경 내용을 컨트롤의 ViewState 속성에 저장하여 같은 페이지에 대한 여러 요청에서 일관되게 유지할 수 있습니다.

(다음에서 상속됨 DataControlField)

적용 대상

추가 정보