TemplateField 클래스

참조

정의

네임스페이스:: System.Web.UI.WebControls

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

데이터 바인딩된 컨트롤에서 사용자 지정 콘텐츠를 표시하는 필드를 나타냅니다.

public ref class TemplateField : System::Web::UI::WebControls::DataControlField

public class TemplateField : System.Web.UI.WebControls.DataControlField

type TemplateField = class
    inherit DataControlField

Public Class TemplateField
Inherits DataControlField

상속: Object

DataControlField
TemplateField

예제

다음 코드 예제에는 사용자 지정을 만드는 방법을 보여 줍니다 TemplateField 같은 셀에서 두 필드를 표시 하는 개체입니다. 첫 번째 이름과 마지막 이름 필드를 동일한 결합 됩니다 TemplateField 개체입니다.


<%@ 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>TemplateField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>TemplateField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- Create a custom TemplateField column that uses      -->
      <!-- two Label controls to display an author's first and -->
      <!-- last name in the same column.                       -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:templatefield headertext="Author Name">
            <itemtemplate>
              <asp:label id="FirstNameLabel"
                Text= '<%# Eval("au_fname") %>'
                runat="server"/> 
              <asp:label id="LastNameLabel"
                Text= '<%# Eval("au_lname") %>'
                runat="server"/>
            </itemtemplate>
          </asp:templatefield>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        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>TemplateField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>TemplateField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- Create a custom TemplateField column that uses      -->
      <!-- two Label controls to display an author's first and -->
      <!-- last name in the same column.                       -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:templatefield headertext="Author Name">
            <itemtemplate>
              <asp:label id="FirstNameLabel"
                text= '<%# Eval("au_fname") %>'
                runat="server"/> 
              <asp:label id="LastNameLabel"
                text= '<%# Eval("au_lname") %>'
                runat="server"/>
            </itemtemplate>
          </asp:templatefield>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

설명

TemplateField 클래스는 데이터 바인딩된 컨트롤에서 사용 (같은 GridView 및 DetailsView) 표시 되는 각 레코드에 대 한 사용자 지정 콘텐츠를 표시 합니다. 하지에서 제공 하는 미리 정의 된 데이터 컨트롤 필드를 데이터 바인딩된 컨트롤에서 콘텐츠를 표시 해야 하는 경우 (같은 BoundField)를 사용 하 여를 TemplateField 사용자 지정 사용자 인터페이스 (UI)를 만들 클래스. TemplateField 개체가 사용 되는 데이터 바인딩된 컨트롤에 따라 다르게 표시 됩니다. 예를 들어 합니다 GridView 컨트롤이 표시는 TemplateField 열을 개체로 및 DetailsView 컨트롤 행으로 표시 합니다.

다른 부분에 대 한 사용자 지정 템플릿을 정의할 수는 TemplateField 다음 표에 나열 된 템플릿을 사용 하 여 개체입니다.

템플릿	Description
AlternatingItemTemplate	교대로 반복 되는 항목에 대해 표시할 콘텐츠를 지정 된 TemplateField 개체입니다.
EditItemTemplate	항목에서 편집 모드에 대해 표시할 콘텐츠를 지정 된 TemplateField 개체입니다.
FooterTemplate	바닥글 구역에 표시할 내용을 지정 된 TemplateField 개체입니다.
HeaderTemplate	머리글 구역에 표시할 콘텐츠를 지정 된 TemplateField 개체입니다.
InsertItemTemplate	항목에서 삽입 모드에 대해 표시할 콘텐츠를 지정 된 TemplateField 개체입니다. 이 서식 파일 에서만 지원 됩니다는 DetailsView 제어 합니다.
ItemTemplate	항목에 대해 표시할 콘텐츠를 지정 된 TemplateField 개체입니다.

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

사용자 지정을 정의 하는 대신 HeaderTemplate 또는 FooterTemplate 템플릿을 사용자 지정할 수 있습니다의 머리글 및 바닥글 섹션을 TemplateField 의 다른 속성을 설정 하 여 개체를 TemplateField 개체입니다. 캡션을 머리글 또는 바닥글 구역에 표시할 설정 합니다 HeaderText 또는 FooterText 속성을 각각. 헤더 섹션에 텍스트를 표시 하는 대신 설정 하 여 이미지를 표시할 수는 HeaderImageUrl 속성입니다. 헤더 섹션에 숨겨져 있을 수는 TemplateField 설정 하 여 개체를 ShowHeader 속성을 false입니다.

참고

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

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

스타일 속성	Description
ControlStyle	자식 웹 서버 컨트롤에 대 한 스타일 설정을 TemplateField 개체입니다.
FooterStyle	바닥글 구역에 대 한 스타일 설정을 TemplateField 개체입니다.
HeaderStyle	머리글 구역에 대 한 스타일 설정을 TemplateField 개체입니다.
ItemStyle	데이터 항목에 대 한 스타일 설정이 TemplateField 개체입니다.

생성자

TemplateField()

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

속성

AccessibleHeaderText	일부 컨트롤에서 `AbbreviatedText` 속성 값으로 렌더링되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
AlternatingItemTemplate	TemplateField 개체에서 교대로 반복되는 항목을 표시하기 위한 템플릿을 가져오거나 설정합니다.
Control	DataControlField 개체가 연결된 데이터 컨트롤에 대한 참조를 가져옵니다. (다음에서 상속됨 DataControlField)
ControlStyle	DataControlField 개체에 포함된 웹 서버 컨트롤의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField)
ConvertEmptyStringToNull	TemplateField 개체가 바인딩된 값이 Empty일 경우 이 값을 `null`로 변환할지 여부를 나타내는 값을 가져오거나 설정합니다.
DesignMode	데이터 컨트롤 필드가 현재 디자인 타임 환경에서 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField)
EditItemTemplate	TemplateField 개체에서 편집 모드의 항목을 표시하기 위한 템플릿을 가져오거나 설정합니다.
FooterStyle	데이터 컨트롤 필드의 바닥글 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
FooterTemplate	TemplateField 개체의 바닥글 구역을 표시하기 위한 템플릿을 가져오거나 설정합니다.
FooterText	데이터 컨트롤 필드의 바닥글 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
HeaderImageUrl	데이터 컨트롤 필드의 머리글 항목에 표시되는 이미지의 URL을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
HeaderStyle	데이터 컨트롤 필드의 머리글 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
HeaderTemplate	TemplateField 개체의 머리글 구역을 표시하기 위한 템플릿을 가져오거나 설정합니다.
HeaderText	데이터 컨트롤 필드의 머리글 항목에 표시되는 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
InsertItemTemplate	TemplateField 개체에서 삽입 모드의 항목을 표시하기 위한 템플릿을 가져오거나 설정합니다.
InsertVisible	데이터 바인딩된 부모 컨트롤이 삽입 모드에 있는 경우 DataControlField 개체가 표시되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField)
IsTrackingViewState	DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField)
ItemStyle	데이터 컨트롤 필드에 표시되는 텍스트 기반 내용의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField)
ItemTemplate	데이터 바인딩된 컨트롤에 항목을 표시하기 위한 템플릿을 가져오거나 설정합니다.
ShowHeader	데이터 컨트롤 필드의 머리글 항목이 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
SortExpression	데이터 소스 컨트롤에서 데이터를 정렬하는 데 사용되는 정렬 식을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
ValidateRequestMode	컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다.
ValidateRequestMode	컨트롤이 클라이언트 입력의 유효성을 검사하는지 여부를 지정하는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
ViewState	같은 페이지에 대한 여러 개의 요청 전반에 DataControlField 개체의 뷰 상태를 저장하고 복원하는 데 사용할 수 있는 상태 정보 사전을 가져옵니다. (다음에서 상속됨 DataControlField)
Visible	데이터 컨트롤 필드가 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)

메서드

CloneField()	현재 DataControlField에서 파생된 개체의 복사본을 만듭니다. (다음에서 상속됨 DataControlField)
CopyProperties(DataControlField)	현재 TemplateField에서 파생된 개체의 속성을 지정된 DataControlField 개체로 복사합니다.
CreateField()	새 TemplateField 개체를 만듭니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	현재 테이블 셀에서 하나 이상의 양방향 바인딩 문(`DataBind`)으로 지정된 데이터 컨트롤 필드의 값을 추출하고 이 값을 지정된 IOrderedDictionary 컬렉션에 추가합니다.)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
Initialize(Boolean, Control)	데이터 컨트롤 필드에 대한 기본 인스턴스 초기화를 수행합니다. (다음에서 상속됨 DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	셀의 컨트롤 컬렉션에 텍스트 또는 컨트롤을 추가합니다.
LoadViewState(Object)	데이터 소스 뷰를 이전에 저장된 뷰 상태로 복원합니다. (다음에서 상속됨 DataControlField)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnFieldChanged()	`FieldChanged` 이벤트를 발생시킵니다. (다음에서 상속됨 DataControlField)
SaveViewState()	페이지가 서버에 포스트백된 이후의 DataControlField 뷰 상태 변경 내용을 저장합니다. (다음에서 상속됨 DataControlField)
ToString()	이 DataControlField 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 DataControlField)
TrackViewState()	DataControlField 개체가 뷰 상태의 변경 내용을 추적하도록 합니다. 이렇게 하면 해당 뷰 상태의 변경 내용을 컨트롤의 ViewState 속성에 저장하여 같은 페이지에 대한 여러 요청에서 일관되게 유지할 수 있습니다. (다음에서 상속됨 DataControlField)
ValidateSupportsCallback()	TemplateField 개체에 들어 있는 컨트롤에서 페이지 콜백이 지원되는지 여부를 확인합니다.

명시적 인터페이스 구현

IDataSourceViewSchemaAccessor.DataSourceViewSchema	이 DataControlField 개체에 연결된 스키마를 가져오거나 설정합니다. (다음에서 상속됨 DataControlField)
IStateManager.IsTrackingViewState	DataControlField 개체가 해당 뷰 상태의 변경 내용을 저장하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataControlField)
IStateManager.LoadViewState(Object)	데이터 컨트롤 필드를 이전에 저장된 뷰 상태로 복원합니다. (다음에서 상속됨 DataControlField)
IStateManager.SaveViewState()	페이지가 서버에 포스트백된 이후의 DataControlField 뷰 상태 변경 내용을 저장합니다. (다음에서 상속됨 DataControlField)
IStateManager.TrackViewState()	DataControlField 개체가 뷰 상태의 변경 내용을 추적하도록 합니다. 이렇게 하면 해당 뷰 상태의 변경 내용을 컨트롤의 ViewState 속성에 저장하여 같은 페이지에 대한 여러 요청에서 일관되게 유지할 수 있습니다. (다음에서 상속됨 DataControlField)

적용 대상

TemplateField 클래스

정의

예제

설명

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

피드백

추가 리소스