Compartilhar via


TemplateField Classe

Definição

Representa um campo que exibe conteúdo personalizado em um controle de associação de dados.

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
Herança
TemplateField

Exemplos

O exemplo de código a seguir demonstra como criar um objeto personalizado TemplateField que exibe dois campos na mesma célula. Os campos nome e sobrenome são combinados no mesmo TemplateField objeto.


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

Comentários

A TemplateField classe é usada por controles associados a dados (como GridView e DetailsView) para exibir conteúdo personalizado para cada registro exibido. Quando você precisar exibir conteúdo em um controle associado a dados que não é fornecido por um dos campos de controle de dados predefinidos (como BoundField), use a TemplateField classe para criar sua interface do usuário personalizada. O TemplateField objeto é exibido de forma diferente dependendo do controle associado a dados no qual ele é usado. Por exemplo, o GridView controle exibe um TemplateField objeto como uma coluna e o controle o DetailsView exibe como uma linha.

Você pode definir um modelo personalizado para as diferentes partes do TemplateField objeto usando os modelos listados na tabela a seguir.

Modelo Descrição
AlternatingItemTemplate Especifica o conteúdo a ser exibido para os itens alternados em um TemplateField objeto .
EditItemTemplate Especifica o conteúdo a ser exibido para um item no modo de edição em um TemplateField objeto .
FooterTemplate Especifica o conteúdo a ser exibido para a seção de rodapé de um TemplateField objeto .
HeaderTemplate Especifica o conteúdo a ser exibido para a seção de cabeçalho de um TemplateField objeto .
InsertItemTemplate Especifica o conteúdo a ser exibido para um item no modo de inserção em um TemplateField objeto . Este modelo tem suporte apenas pelo DetailsView controle .
ItemTemplate Especifica o conteúdo a ser exibido para os itens em um TemplateField objeto .

Você pode ocultar um TemplateField objeto em um controle associado a dados definindo a Visible propriedade falsecomo .

Como alternativa à definição de um modelo ou FooterTemplate personalizadoHeaderTemplate, você pode personalizar as seções de cabeçalho e rodapé de um TemplateField objeto definindo outras propriedades do TemplateField objeto. Para exibir um legenda nas seções de cabeçalho ou rodapé, defina a HeaderText propriedade ou FooterText , respectivamente. Em vez de exibir texto na seção de cabeçalho, você pode exibir uma imagem definindo a HeaderImageUrl propriedade . A seção de cabeçalho pode ser ocultada no TemplateField objeto definindo a ShowHeader propriedade falsecomo .

Observação

Alguns controles associados a dados (como o GridView controle) podem mostrar ou ocultar apenas toda a seção de cabeçalho do controle. Esses controles associados a dados não dão suporte à ShowHeader propriedade para um campo associado individual. Para mostrar ou ocultar toda a seção de cabeçalho de um controle associado a dados, use a propriedade do ShowHeader controle (se disponível).

Você também pode personalizar a aparência do objeto (cor da TemplateField fonte, cor da tela de fundo e assim por diante) definindo as propriedades de estilo para as diferentes partes do campo. A tabela a seguir lista as diferentes propriedades de estilo.

Propriedade Style Descrição
ControlStyle As configurações de estilo para os controles de servidor Web filho do TemplateField objeto.
FooterStyle As configurações de estilo para a seção de rodapé do TemplateField objeto.
HeaderStyle As configurações de estilo para a seção de cabeçalho do TemplateField objeto.
ItemStyle As configurações de estilo para os itens de dados no TemplateField objeto .

Construtores

TemplateField()

Inicializa uma nova instância da classe TemplateField.

Propriedades

AccessibleHeaderText

Obtém ou define o texto que é renderizado como o valor da propriedade AbbreviatedText em alguns controles.

(Herdado de DataControlField)
AlternatingItemTemplate

Obtém ou define o modelo de exibição dos itens alternados em um objeto TemplateField.

Control

Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado.

(Herdado de DataControlField)
ControlStyle

Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField.

(Herdado de DataControlField)
ConvertEmptyStringToNull

Obtém ou define um valor que indica se o valor ao qual o objeto TemplateField está associado deverá ser convertido em null se ele for Empty.

DesignMode

Obtém um valor que indica se um campo de controle de dados é atualmente exibido em um ambiente de tempo de design.

(Herdado de DataControlField)
EditItemTemplate

Obtém ou define o modelo para exibir um item no modo de edição em um objeto TemplateField.

FooterStyle

Obtém ou define o estilo do rodapé do campo de controle de dados.

(Herdado de DataControlField)
FooterTemplate

Obtém ou define o modelo para exibir a seção de rodapé de um objeto TemplateField.

FooterText

Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados.

(Herdado de DataControlField)
HeaderImageUrl

Obtém ou define a URL de uma imagem exibida no item de cabeçalho de um campo de controle de dados.

(Herdado de DataControlField)
HeaderStyle

Obtém ou define o estilo do cabeçalho do campo de controle de dados.

(Herdado de DataControlField)
HeaderTemplate

Obtém ou define o modelo para exibir a seção de cabeçalho de um objeto TemplateField.

HeaderText

Obtém ou define o texto exibido no item de cabeçalho de um campo de controle de dados.

(Herdado de DataControlField)
InsertItemTemplate

Obtém ou define o modelo para exibir um item no modo de inserção em um objeto TemplateField.

InsertVisible

Obtém um valor que indica se o objeto DataControlField fica visível quando o controle associado a dados pai está no modo de inserção.

(Herdado de DataControlField)
IsTrackingViewState

Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.

(Herdado de DataControlField)
ItemStyle

Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados.

(Herdado de DataControlField)
ItemTemplate

Obtém ou define o modelo para exibir um item em um controle de associação de dados.

ShowHeader

Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado.

(Herdado de DataControlField)
SortExpression

Obtém ou define uma expressão de classificação que é usada por um controle de fonte de dados para classificar os dados.

(Herdado de DataControlField)
ValidateRequestMode

Obtém ou define um valor que especifica se o controle valida a entrada do cliente.

ValidateRequestMode

Obtém ou define um valor que especifica se o controle valida a entrada do cliente.

(Herdado de DataControlField)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto DataControlField em várias solicitações da mesma página.

(Herdado de DataControlField)
Visible

Obtém ou define um valor que indica se um campo de controle de dados é renderizado.

(Herdado de DataControlField)

Métodos

CloneField()

Cria uma cópia duplicada do objeto atual derivado de DataControlField.

(Herdado de DataControlField)
CopyProperties(DataControlField)

Copia as propriedades do objeto atual derivado de TemplateField para o objeto DataControlField especificado.

CreateField()

Cria um novo objeto TemplateField.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrai o valor dos campos de controle de dados conforme especificado por uma ou mais declarações de associação bidirecional (DataBind) da célula da tabela atual e adiciona os valores à coleção IOrderedDictionary especificada.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Initialize(Boolean, Control)

Executa a inicialização de instância básica para um campo de controle de dados.

(Herdado de DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Adiciona texto ou controles à coleção de controles da célula.

LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.

(Herdado de DataControlField)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
OnFieldChanged()

Aciona o evento FieldChanged.

(Herdado de DataControlField)
SaveViewState()

Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor.

(Herdado de DataControlField)
ToString()

Retorna uma cadeia de caracteres que representa este objeto DataControlField.

(Herdado de DataControlField)
TrackViewState()

Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página.

(Herdado de DataControlField)
ValidateSupportsCallback()

Determina se os controles contidos em um objeto TemplateField dão suporte a retornos de chamada de página.

Implantações explícitas de interface

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtém ou define o esquema associado a este objeto DataControlField.

(Herdado de DataControlField)
IStateManager.IsTrackingViewState

Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.

(Herdado de DataControlField)
IStateManager.LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente do campo de controle de dados.

(Herdado de DataControlField)
IStateManager.SaveViewState()

Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor.

(Herdado de DataControlField)
IStateManager.TrackViewState()

Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página.

(Herdado de DataControlField)

Aplica-se a

Confira também