TemplateField Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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: Object

DataControlField
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

Compartilhar via