TemplateField Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um campo que apresenta conteúdo personalizado num controlo vinculado a 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 seguinte demonstra como criar um objeto personalizado TemplateField que exibe dois campos na mesma célula. Os campos de nome e apelido 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>

Observações

A TemplateField classe é usada por controlos encadenados por dados (como GridView e DetailsView) para exibir conteúdo personalizado para cada registo exibido. Quando precisar de mostrar conteúdo num controlo vinculado a dados que não é fornecido por um dos campos de controlo de dados predefinidos (como BoundField), use a TemplateField classe para criar a sua interface de utilizador personalizada (UI). O TemplateField objeto é apresentado de forma diferente consoante o controlo limitado por dados em que é utilizado. Por exemplo, o controlo GridView apresenta um TemplateField objeto como uma coluna, e o DetailsView controlo mostra-o como uma linha.

Pode definir um modelo personalizado para as diferentes partes do TemplateField objeto usando os modelos listados na tabela seguinte.

Template	Description
AlternatingItemTemplate	Especifica o conteúdo a mostrar para os itens alternados num TemplateField objeto.
EditItemTemplate	Especifica o conteúdo a mostrar para um item em modo de edição num TemplateField objeto.
FooterTemplate	Especifica o conteúdo a apresentar para a secção de rodapé de um TemplateField objeto.
HeaderTemplate	Especifica o conteúdo a mostrar para a secção do cabeçalho de um TemplateField objeto.
InsertItemTemplate	Especifica o conteúdo a mostrar para um item em modo de inserção num TemplateField objeto. Este modelo é suportado apenas pelo DetailsView controlo.
ItemTemplate	Especifica o conteúdo a mostrar para os itens de um TemplateField objeto.

Pode esconder um TemplateField objeto num controlo data-bound definindo a Visible propriedade para false.

Como alternativa a definir um custom HeaderTemplate ou FooterTemplate template, pode personalizar as secções do cabeçalho e rodapé de um TemplateField objeto definindo outras propriedades do TemplateField objeto. Para mostrar uma legenda nas secções do cabeçalho ou rodapé, defina a HeaderText ou a FooterText propriedade, respetivamente. Em vez de mostrar texto na secção do cabeçalho, pode mostrar uma imagem definindo a HeaderImageUrl propriedade. A secção do cabeçalho pode ser ocultada no TemplateField objeto ao definir a ShowHeader propriedade para false.

Note

Alguns controlos ligados a dados (como o controlo GridView ) podem mostrar ou ocultar apenas toda a secção do cabeçalho do controlo. Estes controlos ligados a dados não suportam a ShowHeader propriedade para um campo ligado individual. Para mostrar ou ocultar toda a secção do cabeçalho de um controlo data-bound, use a propriedade do ShowHeader controlo (se disponível).

Também pode personalizar a aparência do TemplateField objeto (cor da fonte, cor de fundo, etc.) definindo as propriedades de estilo para as diferentes partes do campo. A tabela seguinte lista as diferentes propriedades de estilo.

Propriedade de estilo	Description
ControlStyle	As definições de estilo do servidor Web filho controlam o TemplateField objeto.
FooterStyle	As definições de estilo para a secção do rodapé do TemplateField objeto.
HeaderStyle	As definições de estilo para a secção do cabeçalho do TemplateField objeto.
ItemStyle	As definições de estilo para os itens de dados no TemplateField objeto.

Construtores

Name	Description
TemplateField()	Inicializa uma nova instância da TemplateField classe.

Propriedades

Name	Description
AccessibleHeaderText	Recebe ou define texto que é renderizado como valor de `AbbreviatedText` propriedade em alguns controlos. (Herdado de DataControlField)
AlternatingItemTemplate	Obtém ou define o modelo para exibir os itens alternados num TemplateField objeto.
Control	Obtém uma referência ao controlo de dados ao qual o DataControlField objeto está associado. (Herdado de DataControlField)
ControlStyle	Obtém o estilo de quaisquer controlos de servidor Web contidos pelo DataControlField objeto. (Herdado de DataControlField)
ConvertEmptyStringToNull	Obtém ou define um valor que indica se o valor ao qual o TemplateField objeto está ligado deve ser convertido se `null` for Empty.
DesignMode	Obtém um valor que indica se um campo de controlo de dados está atualmente visualizado num ambiente em tempo de design. (Herdado de DataControlField)
EditItemTemplate	Obtém ou define o modelo para exibir um item em modo de edição num TemplateField objeto.
FooterStyle	Obtém ou define o estilo do rodapé do campo de controlo de dados. (Herdado de DataControlField)
FooterTemplate	Obtém ou define o modelo para mostrar a secção do rodapé de um TemplateField objeto.
FooterText	Recebe ou define o texto que é exibido no elemento de rodapé de um campo de controlo de dados. (Herdado de DataControlField)
HeaderImageUrl	Obtém ou define a URL de uma imagem que é exibida no elemento do cabeçalho de um campo de controlo de dados. (Herdado de DataControlField)
HeaderStyle	Obtém ou define o estilo do cabeçalho do campo de controlo de dados. (Herdado de DataControlField)
HeaderTemplate	Obtém ou define o modelo para mostrar a secção do cabeçalho de um TemplateField objeto.
HeaderText	Obtém ou define o texto que é exibido no elemento do cabeçalho de um campo de controlo de dados. (Herdado de DataControlField)
InsertItemTemplate	Obtém ou define o modelo para exibir um item em modo de inserção num TemplateField objeto.
InsertVisible	Recebe um valor que indica se o DataControlField objeto é visível quando o controlo de dados do pai está em modo de inserção. (Herdado de DataControlField)
IsTrackingViewState	Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField)
ItemStyle	Obtém o estilo de qualquer conteúdo baseado em texto apresentado por um campo de controlo de dados. (Herdado de DataControlField)
ItemTemplate	Obtém ou define o modelo para exibir um item num controlo ligado a dados.
ShowHeader	Recebe ou define um valor que indica se o elemento do cabeçalho de um campo de controlo de dados é renderizado. (Herdado de DataControlField)
SortExpression	Obtém ou define uma expressão de ordenação que é usada por um controlo de fonte de dados para ordenar dados. (Herdado de DataControlField)
ValidateRequestMode	Recebe ou define um valor que especifica se o controlo valida a entrada do cliente.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um DataControlField objeto através de múltiplos pedidos para a mesma página. (Herdado de DataControlField)
Visible	Recebe ou define um valor que indica se um campo de controlo de dados é renderizado. (Herdado de DataControlField)

Métodos

Name	Description
CloneField()	Cria uma cópia duplicada do objeto derivado atualmente DataControlField. (Herdado de DataControlField)
CopyProperties(DataControlField)	Copia as propriedades do objeto derivado atual TemplateFieldpara o objeto especificado DataControlField .
CreateField()	Cria um novo TemplateField objeto.
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 controlo de dados conforme especificado por uma ou mais instruções de ligação bidirecional (`DataBind`) da célula da tabela atual e adiciona os valores à coleção especificada IOrderedDictionary .
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Initialize(Boolean, Control)	Realiza a inicialização básica da instância para um campo de controlo de dados. (Herdado de DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Adiciona texto ou controlos à coleção de controlos de uma célula.
LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de DataControlField)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnFieldChanged()	Eleva o `FieldChanged` evento. (Herdado de DataControlField)
SaveViewState()	Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField)
ToString()	Devolve uma cadeia que representa este DataControlField objeto. (Herdado de DataControlField)
TrackViewState()	Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField)
ValidateSupportsCallback()	Determina se os controlos contidos num TemplateField objeto suportam chamadas de retorno de página.

Implementações de Interface Explícita

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtém ou define o esquema associado a este DataControlField objeto. (Herdado de DataControlField)
IStateManager.IsTrackingViewState	Recebe um valor que indica se o DataControlField objeto está a guardar alterações ao seu estado de visualização. (Herdado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura o estado de visualização previamente guardado do campo de controlo de dados. (Herdado de DataControlField)
IStateManager.SaveViewState()	Guarda as alterações feitas ao DataControlField estado de visualização desde o momento em que a página foi publicada de volta no servidor. (Herdado de DataControlField)
IStateManager.TrackViewState()	Faz com que o DataControlField objeto acompanhe alterações ao estado da visualização para que possam ser armazenadas na propriedade do ViewState controlo e persistirem entre pedidos para a mesma página. (Herdado de DataControlField)

Aplica-se a

Ver também

Comentários

Esta página foi útil?