이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

ButtonField 클래스

 

게시 날짜: 2016년 11월

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

네임스페이스:   System.Web.UI.WebControls
어셈블리:  System.Web(System.Web.dll에 있음)


public class ButtonField : ButtonFieldBase

이름설명
System_CAPS_pubmethodButtonField()

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

이름설명
System_CAPS_pubpropertyAccessibleHeaderText

렌더링 되는 텍스트를 가져오거나 설정 합니다.는 AbbreviatedText 일부 컨트롤의 속성 값입니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyButtonType

단추 필드에 표시할 단추 종류를 가져오거나 설정 합니다.(ButtonFieldBase에서 상속됨)

System_CAPS_pubpropertyCausesValidation

에 있는 단추 유효성 검사를 수행할지 여부를 나타내는 값을 가져오거나 설정 합니다.는 ButtonFieldBase 개체를 클릭 합니다.(ButtonFieldBase에서 상속됨)

System_CAPS_pubpropertyCommandName

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

System_CAPS_protpropertyControl

데이터 컨트롤에 대 한 참조를 가져옵니다는 DataControlField 개체가 연결 되어 있습니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyControlStyle

포함 된 모든 웹 서버 컨트롤의 스타일을 가져옵니다는 DataControlField 개체입니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyDataTextField

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

System_CAPS_pubpropertyDataTextFormatString

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

System_CAPS_protpropertyDesignMode

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

System_CAPS_pubpropertyFooterStyle

데이터 제어 필드의 바닥글의 스타일을 가져오거나 설정 합니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyFooterText

데이터 제어 필드의 바닥글 항목에 표시 되는 텍스트를 가져오거나 설정 합니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyHeaderImageUrl

데이터 제어 필드의 헤더 항목에 표시 되는 이미지의 URL을 가져오거나 설정 합니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyHeaderStyle

데이터 제어 필드의 머리글의 스타일을 가져오거나 설정 합니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyHeaderText

데이터 제어 필드의 헤더 항목에 표시 되는 텍스트를 가져오거나 설정 합니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyImageUrl

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

System_CAPS_pubpropertyInsertVisible

나타내는 값을 가져옵니다 여부는 DataControlField 개체는 부모 데이터 바인딩 컨트롤이 삽입 모드에 있을 때 표시 됩니다.(DataControlField에서 상속됨)

System_CAPS_protpropertyIsTrackingViewState

나타내는 값을 가져옵니다 여부는 DataControlField 개체는 해당 뷰 상태의 변경 내용을 저장 합니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyItemStyle

데이터 컨트롤 필드에서 표시 하는 텍스트 기반 콘텐츠 스타일을 가져옵니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyShowHeader

헤더 섹션에 표시 되는지 여부를 나타내는 값을 가져오거나 설정 합니다.는 ButtonFieldBase 개체입니다.(ButtonFieldBase에서 상속됨)

System_CAPS_pubpropertySortExpression

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

System_CAPS_pubpropertyText

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

System_CAPS_protpropertyValidateRequestMode

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

System_CAPS_pubpropertyValidationGroup

유효성을 검사할 때 단추에 대 한 유효성 검사 컨트롤의 그룹의 이름을 가져오거나 설정 합니다.는 ButtonFieldBase 개체를 클릭 합니다.(ButtonFieldBase에서 상속됨)

System_CAPS_protpropertyViewState

상태 정보를 저장 하 고의 뷰 상태를 복원 하면의 사전을 가져옵니다는 DataControlField 같은 페이지에 대 한 여러 요청에 대해 개체입니다.(DataControlField에서 상속됨)

System_CAPS_pubpropertyVisible

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

이름설명
System_CAPS_protmethodCloneField()

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 현재의 중복 복사본을 만듭니다 DataControlField-파생 개체입니다.(DataControlField에서 상속됨)

System_CAPS_protmethodCopyProperties(DataControlField)

현재 속성을 복사 ButtonField 개체는 지정 된 DataControlField 개체입니다.(ButtonFieldBase.CopyProperties(DataControlField)을(를) 재정의함)

System_CAPS_protmethodCreateField()

만들고의 새 인스턴스를 반환 합니다.는 ButtonField 클래스입니다.(DataControlField.CreateField()을(를) 재정의함)

System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)

System_CAPS_pubmethodExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

현재 테이블 셀에서 컨트롤 데이터 필드의 값을 추출 하 고 값을 지정 된 추가 IDictionary 컬렉션입니다.(DataControlField에서 상속됨)

System_CAPS_protmethodFinalize()

개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)

System_CAPS_protmethodFormatDataTextValue(Object)

셀에 대 한 지정 된 필드 값의 서식을 ButtonField 개체입니다.

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다.(Object에서 상속됨)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_pubmethodInitialize(Boolean, Control)

현재 ButtonField 개체를 초기화합니다.(DataControlField.Initialize(Boolean, Control)을(를) 재정의함)

System_CAPS_pubmethodInitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

지정 된 초기화 DataControlFieldCell 개체는 지정 된 행의 상태입니다.(DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)을(를) 재정의함)

System_CAPS_protmethodLoadViewState(Object)

이전에 저장 된 데이터 원본 뷰의 뷰 상태를 복원 합니다.(DataControlField에서 상속됨)

System_CAPS_protmethodMemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.(Object에서 상속됨)

System_CAPS_protmethodOnFieldChanged()

FieldChanged 이벤트를 발생시킵니다.(DataControlField에서 상속됨)

System_CAPS_protmethodSaveViewState()

변경 내용을 저장 하는 DataControlField 페이지가 서버에 포스트백 된 이후에 뷰 상태입니다.(DataControlField에서 상속됨)

System_CAPS_pubmethodToString()

이 나타내는 문자열을 반환 DataControlField 개체입니다.(DataControlField에서 상속됨)

System_CAPS_protmethodTrackViewState()

로 인해는 DataControlField 컨트롤의 저장할 수 있도록 해당 뷰 상태의 변경 내용을 추적 하는 개체 ViewState 속성과 같은 페이지에 대 한 전체 지속형된 요청 합니다.(DataControlField에서 상속됨)

System_CAPS_pubmethodValidateSupportsCallback()

컨트롤 하는 지 확인에 포함 된 한 ButtonField 콜백이 지원 개체입니다.(DataControlField.ValidateSupportsCallback()을(를) 재정의함)

이름설명
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 데이터 제어 필드의 이전에 저장 된 뷰 상태를 복원합니다.(DataControlField에서 상속됨)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 변경 내용을 저장 하는 DataControlField 페이지가 서버에 포스트백 된 이후에 뷰 상태입니다.(DataControlField에서 상속됨)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 로 인해는 DataControlField 컨트롤의 저장할 수 있도록 해당 뷰 상태의 변경 내용을 추적 하는 개체 ViewState 속성과 같은 페이지에 대 한 전체 지속형된 요청 합니다.(DataControlField에서 상속됨)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataSourceViewSchemaAccessor.DataSourceViewSchema

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. DataControlField 개체에 연결된 스키마를 가져오거나 설정합니다.(DataControlField에서 상속됨)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 나타내는 값을 가져옵니다 여부는 DataControlField 개체는 해당 뷰 상태의 변경 내용을 저장 합니다.(DataControlField에서 상속됨)

The T:System.Web.UI.WebControls.ButtonField class is used by data-bound controls (such as T:System.Web.UI.WebControls.GridView and T:System.Web.UI.WebControls.DetailsView) to display a button for each record that is displayed. The T:System.Web.UI.WebControls.ButtonField object is displayed differently depending on the data-bound control in which it is used. For example, the T:System.Web.UI.WebControls.GridView control displays a T:System.Web.UI.WebControls.ButtonField object as a column, while the T:System.Web.UI.WebControls.DetailsView control displays it as a row.

Clicking a button in a button field raises the command event of the parent data-bound control. You can provide a custom routine to perform when a command button is clicked by providing an event handler for the command event.

System_CAPS_note참고

The T:System.Web.UI.WebControls.GridView control raises the E:System.Web.UI.WebControls.GridView.RowCommand event, while the T:System.Web.UI.WebControls.DetailsView control raises the E:System.Web.UI.WebControls.DetailsView.ItemCommand event.

To determine the index of the record that raises the command event, use the P:System.Web.UI.WebControls.CommandEventArgs.CommandArgument property of the event argument that is passed to the command event for the data-bound control. The T:System.Web.UI.WebControls.ButtonField class automatically populates the P:System.Web.UI.WebControls.CommandEventArgs.CommandArgument property with the appropriate index value.

To specify the type of button to display, use the P:System.Web.UI.WebControls.ButtonFieldBase.ButtonType property. When displaying a link or command button, use the P:System.Web.UI.WebControls.ButtonField.Text property to specify the caption to display in the buttons.

System_CAPS_note참고

If you set the P:System.Web.UI.WebControls.ButtonField.Text property, all buttons in a T:System.Web.UI.WebControls.ButtonField share the same caption.

Alternatively, you can bind the T:System.Web.UI.WebControls.ButtonField object to a field in a data source. This allows you to display different captions for the buttons in the T:System.Web.UI.WebControls.ButtonField object. The values that are in the specified field are used for the text captions of the buttons. Set the P:System.Web.UI.WebControls.ButtonField.DataTextField property to bind a T:System.Web.UI.WebControls.ButtonField object to a field in a data source.

When displaying an image button, use the P:System.Web.UI.WebControls.ButtonField.ImageUrl property to specify the image to display for the buttons in the T:System.Web.UI.WebControls.ButtonField object.

System_CAPS_note참고

All buttons in a T:System.Web.UI.WebControls.ButtonField object share the same image.

You can hide a T:System.Web.UI.WebControls.ButtonField object in a data-bound control by setting the P:System.Web.UI.WebControls.DataControlField.Visible property to false.

The T:System.Web.UI.WebControls.ButtonField object allows you to customize its header and footer sections. To display a caption in the header or footer section, set the P:System.Web.UI.WebControls.DataControlField.HeaderText or P:System.Web.UI.WebControls.DataControlField.FooterText properties, respectively. Instead of displaying text in the header section, you can display an image by setting the P:System.Web.UI.WebControls.DataControlField.HeaderImageUrl property. To hide the header section in a T:System.Web.UI.WebControls.ButtonField object, set the P:System.Web.UI.WebControls.ButtonFieldBase.ShowHeader property to false.

System_CAPS_note참고

Some data-bound controls (such as the T:System.Web.UI.WebControls.GridView control) can show or hide only the entire header section of the control. These data-bound controls do not support the P:System.Web.UI.WebControls.ButtonFieldBase.ShowHeader property for an individual button field. To show or hide the entire header section of a data-bound control (if available), use the ShowHeader property for the control.

You also can customize the appearance of the T:System.Web.UI.WebControls.ButtonField object (font color, background color, and so on) by setting the style properties for the different parts of the field. The following table lists the different style properties.

Style property

The style settings for

ControlStyle

The child Web server controls of the T:System.Web.UI.WebControls.ButtonField.

FooterStyle

The footer section of the T:System.Web.UI.WebControls.ButtonField.

HeaderStyle

The header section of the T:System.Web.UI.WebControls.ButtonField.

ItemStyle

The data items in the T:System.Web.UI.WebControls.ButtonField.

The following code example demonstrates how to use a T:System.Web.UI.WebControls.ButtonField object to display a column of command buttons in a T:System.Web.UI.WebControls.GridView control.


<%@ 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>

.NET Framework
2.0 이후 사용 가능

이 형식의 모든 public static(Visual Basic의 공유 Visual Basic의 경우) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전이 보장되지 않습니다.

맨 위로 이동
표시: