내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본
이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

ButtonField 클래스

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

네임스페이스:  System.Web.UI.WebControls
어셈블리:  System.Web(System.Web.dll)
public class ButtonField : ButtonFieldBase

ButtonField 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드ButtonField새 인스턴스 초기화를 ButtonField 클래스입니다.
위쪽
  이름설명
Public 속성AccessibleHeaderText렌더링 되는 텍스트를 가져오거나 설정 합니다.의 AbbreviatedText 일부 컨트롤의 속성 값입니다. (DataControlField에서 상속됨)
Public 속성ButtonType단추 필드에 표시할 단추 형식을 가져오거나 설정합니다. (ButtonFieldBase에서 상속됨)
Public 속성CausesValidation ButtonFieldBase 개체의 단추를 클릭한 경우 유효성 검사를 수행할지 여부를 나타내는 값을 가져오거나 설정합니다. (ButtonFieldBase에서 상속됨)
Public 속성CommandName단추를 때 수행할 작업을 나타내는 문자열을 가져오거나 설정 합니다.의 ButtonField 개체를 클릭 합니다.
Protected 속성Control데이터 컨트롤에 대 한 참조를 가져옵니다는 DataControlField 개체가 연결 되어 있습니다. (DataControlField에서 상속됨)
Public 속성ControlStyle에 포함 된 모든 웹 서버 컨트롤의 스타일을 가져옵니다 해당 DataControlField 개체입니다. (DataControlField에서 상속됨)
Public 속성DataTextField값에 바인딩되는 데이터 필드의 이름을 가져오거나 설정 합니다.의 Text 속성의의 Button 으로 렌더링 되는 컨트롤의 ButtonField 개체.
Public 속성DataTextFormatString값 필드의 표시 형식을 지정 하는 문자열을 가져오거나 설정 합니다.
Protected 속성DesignMode데이터 컨트롤 필드가 현재 디자인 타임 환경에서 표시 되는지 여부를 나타내는 값을 가져옵니다. (DataControlField에서 상속됨)
Public 속성FooterStyle데이터 컨트롤 필드의 바닥글 스타일을 가져오거나 설정 합니다. (DataControlField에서 상속됨)
Public 속성FooterText데이터 컨트롤 필드의 바닥글 항목에 표시 되는 텍스트를 가져오거나 설정 합니다. (DataControlField에서 상속됨)
Public 속성HeaderImageUrl데이터 컨트롤 필드의 머리글 항목에 표시 되는 이미지의 URL을 가져오거나 설정 합니다. (DataControlField에서 상속됨)
Public 속성HeaderStyle데이터 컨트롤 필드의 머리글 스타일을 가져오거나 설정 합니다. (DataControlField에서 상속됨)
Public 속성HeaderText데이터 컨트롤 필드의 머리글 항목에 표시 되는 텍스트를 가져오거나 설정 합니다. (DataControlField에서 상속됨)
Public 속성ImageUrl각 단추에 대해 표시할 이미지를 가져오거나 설정 합니다.의 ButtonField 개체입니다.
Public 속성InsertVisible나타내는 값을 가져옵니다 여부를 DataControlField 데이터 바인딩된 부모 컨트롤이 삽입 모드에 있으면 개체가 표시 됩니다. (DataControlField에서 상속됨)
Protected 속성IsTrackingViewState나타내는 값을 가져옵니다 여부를 DataControlField 개체가 해당 뷰 상태의 변경 사항을 저장입니다. (DataControlField에서 상속됨)
Public 속성ItemStyle데이터 컨트롤 필드에 표시 되는 텍스트 기반 내용의 스타일을 가져옵니다. (DataControlField에서 상속됨)
Public 속성ShowHeader ButtonFieldBase 개체에 머리글 구역을 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. (ButtonFieldBase에서 상속됨)
Public 속성SortExpression데이터 소스 컨트롤에서 데이터를 정렬 하는 데 사용 되는 정렬 식을 가져오거나 설정 합니다. (DataControlField에서 상속됨)
Public 속성Text각 단추에 대해 표시할 정적 캡션을 가져오거나 설정 합니다.의 ButtonField 개체입니다.
Protected 속성ValidateRequestMode컨트롤 클라이언트 입력의 유효성을 검사 하는지 여부를 나타내는 값을 가져오거나 설정 합니다. (DataControlField에서 상속됨)
Public 속성ValidationGroup ButtonFieldBase 개체의 단추를 클릭할 때 유효성 검사를 수행할 유효성 검사 컨트롤 그룹의 이름을 가져오거나 설정합니다. (ButtonFieldBase에서 상속됨)
Protected 속성ViewState저장 한 뷰 상태를 복원할 수 있도록 하는 상태 정보 사전을 가져옵니다는 DataControlField 개체를 같은 페이지에 대 한 여러 개의 요청 전반. (DataControlField에서 상속됨)
Public 속성Visible데이터 컨트롤 필드가 렌더링 되는지 여부를 나타내는 값을 가져오거나 설정 합니다. (DataControlField에서 상속됨)
위쪽
  이름설명
Protected 메서드CloneField인프라입니다. 현재의 중복 복사본을 만듭니다 DataControlField-파생 개체입니다. (DataControlField에서 상속됨)
Protected 메서드CopyProperties현재 속성 복사 ButtonField 개체에 지정 된 DataControlField 개체입니다. (ButtonFieldBase.CopyProperties(DataControlField)을(를) 재정의함)
Protected 메서드CreateField만들고 새 인스턴스를 반환의 ButtonField 클래스입니다. (DataControlField.CreateField()을(를) 재정의함)
Public 메서드Equals(Object) 지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)
Public 메서드ExtractValuesFromCell현재 표 셀에서 데이터 컨트롤 필드의 값을 추출 하 고 값에 지정 된 추가 IDictionary 컬렉션입니다. (DataControlField에서 상속됨)
Protected 메서드Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Protected 메서드FormatDataTextValue지정 된 필드 값을 셀에 서식을 설정 하는 ButtonField 개체입니다.
Public 메서드GetHashCode기본 해시 함수로 작동합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드Initialize현재 초기화 ButtonField 개체입니다. (DataControlField.Initialize(Boolean, Control)을(를) 재정의함)
Public 메서드InitializeCell지정 된 초기화 DataControlFieldCell 개체를 지정 된 행 상태로 있습니다. (DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)을(를) 재정의함)
Protected 메서드LoadViewState복원 데이터 원본 보기 이전에 뷰 상태를 저장 합니다. (DataControlField에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Protected 메서드OnFieldChanged발생은 FieldChanged 이벤트입니다. (DataControlField에서 상속됨)
Protected 메서드SaveViewState변경 사항을 저장의 DataControlField 보기 상태로 페이지가 서버에 다시 게시 한 시간 이후에. (DataControlField에서 상속됨)
Public 메서드ToString이 나타내는 string을 반환 합니다. DataControlField 개체입니다. (DataControlField에서 상속됨)
Protected 메서드TrackViewState게는 DataControlField 컨트롤에 저장할 수 있도록 해당 뷰 상태의 변경 내용을 추적 하는 개체 ViewState 속성과 같은 페이지에 대 한 요청 간에 유지 되. (DataControlField에서 상속됨)
Public 메서드ValidateSupportsCallback컨트롤에 있는지 여부를 결정에 포함 된 ButtonField 지원 콜백 개체입니다. (DataControlField.ValidateSupportsCallback()을(를) 재정의함)
위쪽
  이름설명
명시적 인터페이스 구현Private 속성IDataSourceViewSchemaAccessor.DataSourceViewSchema인프라입니다. 이 작업에 연결 된 스키마를 가져오거나 설정 합니다. DataControlField 개체입니다. (DataControlField에서 상속됨)
명시적 인터페이스 구현Private 속성IStateManager.IsTrackingViewState인프라입니다. 나타내는 값을 가져옵니다 여부를 DataControlField 개체가 해당 뷰 상태의 변경 사항을 저장입니다. (DataControlField에서 상속됨)
명시적 인터페이스 구현Private 메서드IStateManager.LoadViewState인프라입니다. 데이터 컨트롤 필드의 이전에 저장 된 뷰 상태로 복원합니다. (DataControlField에서 상속됨)
명시적 인터페이스 구현Private 메서드IStateManager.SaveViewState인프라입니다. 변경 사항을 저장의 DataControlField 보기 상태로 페이지가 서버에 다시 게시 한 시간 이후에. (DataControlField에서 상속됨)
명시적 인터페이스 구현Private 메서드IStateManager.TrackViewState인프라입니다. 게는 DataControlField 컨트롤에 저장할 수 있도록 해당 뷰 상태의 변경 내용을 추적 하는 개체 ViewState 속성과 같은 페이지에 대 한 요청 간에 유지 되. (DataControlField에서 상속됨)
위쪽

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 필드의 다른 부분에 대 한 스타일 속성을 설정 하 여 개체 (글꼴 색, 배경색 등). 다음 표에서 다른 스타일 속성을 나열합니다.

Style 속성

스타일 설정

ControlStyle

자식 웹 서버 컨트롤에 ButtonField.

FooterStyle

바닥글 구역에는 ButtonField.

HeaderStyle

머리글 구역에서 ButtonField.

ItemStyle

데이터 항목은 ButtonField.

다음 코드 예제에서는 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>



.NET Framework

4.5, 4, 3.5, 3.0, 2.0에서 지원

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework 에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 다음을 참조하십시오. .NET Framework 시스템 요구 사항.
이 형식의 static(Visual Basic의 경우 Shared) 모든 공용 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.
이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft. All rights reserved.