TemplateField 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 바인딩된 컨트롤에서 사용자 지정 콘텐츠를 표시하는 필드를 나타냅니다.
public ref class TemplateField : System::Web::UI::WebControls::DataControlFieldpublic class TemplateField : System.Web.UI.WebControls.DataControlFieldtype TemplateField = class
inherit DataControlFieldPublic Class TemplateField
Inherits DataControlField- 상속
예제
다음 코드 예제에는 사용자 지정을 만드는 방법을 보여 줍니다 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 |
일부 컨트롤에서 |
| AlternatingItemTemplate |
TemplateField 개체에서 교대로 반복되는 항목을 표시하기 위한 템플릿을 가져오거나 설정합니다. |
| Control |
DataControlField 개체가 연결된 데이터 컨트롤에 대한 참조를 가져옵니다. (다음에서 상속됨 DataControlField) |
| ControlStyle |
DataControlField 개체에 포함된 웹 서버 컨트롤의 스타일을 가져옵니다. (다음에서 상속됨 DataControlField) |
| ConvertEmptyStringToNull |
TemplateField 개체가 바인딩된 값이 Empty일 경우 이 값을 |
| 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) |
현재 테이블 셀에서 하나 이상의 양방향 바인딩 문( |
| GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
| GetType() |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
| Initialize(Boolean, Control) |
데이터 컨트롤 필드에 대한 기본 인스턴스 초기화를 수행합니다. (다음에서 상속됨 DataControlField) |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
셀의 컨트롤 컬렉션에 텍스트 또는 컨트롤을 추가합니다. |
| LoadViewState(Object) |
데이터 소스 뷰를 이전에 저장된 뷰 상태로 복원합니다. (다음에서 상속됨 DataControlField) |
| MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| OnFieldChanged() |
|
| 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) |
적용 대상
추가 정보
.NET