TemplateField Classe

Definição

Representa um campo que exibe conteúdo personalizado em um controle de associação de dados.Represents a field that displays custom content in a data-bound control.

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 TemplateField objeto personalizado que exibe dois campos na mesma célula.The following code example demonstrates how to create a custom TemplateField object that displays two fields in the same cell. Os campos nome e sobrenome são combinados no mesmo TemplateField objeto.The first name and last name fields are combined into the same TemplateField object.


<%@ 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 vinculados a dados (como GridView e DetailsView ) para exibir conteúdo personalizado para cada registro exibido.The TemplateField class is used by data-bound controls (such as GridView and DetailsView) to display custom content for each record displayed. Quando você precisa exibir o conteúdo em um controle de vinculação de 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.When you need to display content in a data-bound control that is not provided by one of the predefined data control fields (such as BoundField), use the TemplateField class to create your custom user interface (UI). O TemplateField objeto é exibido de forma diferente, dependendo do controle vinculado a dados no qual ele é usado.The TemplateField object is displayed differently depending on the data-bound control in which it is used. Por exemplo, o GridView controle exibe um TemplateField objeto como uma coluna e o DetailsView controle o exibe como uma linha.For example, the GridView control displays a TemplateField object as a column, and the DetailsView control displays it as a row.

Você pode definir um modelo personalizado para as diferentes partes do TemplateField objeto usando os modelos listados na tabela a seguir.You can define a custom template for the different parts of the TemplateField object using the templates listed in the following table.

ModeloTemplate DescriçãoDescription
AlternatingItemTemplate Especifica o conteúdo a ser exibido para os itens alternados em um TemplateField objeto.Specifies the content to display for the alternating items in a TemplateField object.
EditItemTemplate Especifica o conteúdo a ser exibido para um item no modo de edição em um TemplateField objeto.Specifies the content to display for an item in edit mode in a TemplateField object.
FooterTemplate Especifica o conteúdo a ser exibido para a seção de rodapé de um TemplateField objeto.Specifies the content to display for the footer section of a TemplateField object.
HeaderTemplate Especifica o conteúdo a ser exibido para a seção de cabeçalho de um TemplateField objeto.Specifies the content to display for the header section of a TemplateField object.
InsertItemTemplate Especifica o conteúdo a ser exibido para um item no modo de inserção em um TemplateField objeto.Specifies the content to display for an item in insert mode in a TemplateField object. Esse modelo tem suporte apenas pelo DetailsView controle.This template is supported only by the DetailsView control.
ItemTemplate Especifica o conteúdo a ser exibido para os itens em um TemplateField objeto.Specifies the content to display for the items in a TemplateField object.

Você pode ocultar um TemplateField objeto em um controle vinculado a dados definindo a Visible propriedade como false .You can hide a TemplateField object in a data-bound control by setting the Visible property to false.

Como alternativa à definição de um HeaderTemplate modelo ou personalizado FooterTemplate , você pode personalizar as seções de cabeçalho e rodapé de um TemplateField objeto definindo outras propriedades do TemplateField objeto.As an alternative to defining a custom HeaderTemplate or FooterTemplate template, you can customize the header and footer sections of a TemplateField object by setting other properties of the TemplateField object. Para exibir uma legenda nas seções de cabeçalho ou rodapé, defina a HeaderText propriedade ou FooterText , respectivamente.To display a caption in the header or footer sections, set the HeaderText or the FooterText property, respectively. Em vez de exibir texto na seção de cabeçalho, você pode exibir uma imagem definindo a HeaderImageUrl propriedade.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. A seção de cabeçalho pode ser ocultada no TemplateField objeto definindo a ShowHeader propriedade como false .The header section can be hidden in the TemplateField object by setting the ShowHeader property to false.

Observação

Alguns controles ligados a dados (como o GridView controle) podem mostrar ou ocultar apenas a seção de cabeçalho inteira do controle.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Esses controles associados a dados não oferecem suporte à ShowHeader propriedade para um campo associado individual.These data-bound controls do not support the ShowHeader property for an individual bound field. Para mostrar ou ocultar a seção de cabeçalho inteira de um controle de vinculação de dados, use a ShowHeader Propriedade do controle (se disponível).To show or hide the entire header section of a data-bound control, use the control's ShowHeader property (if available).

Você também pode personalizar a aparência do TemplateField objeto (cor da fonte, cor do plano de fundo e assim por diante) definindo as propriedades de estilo para as diferentes partes do campo.You also can customize the appearance of the TemplateField object (font color, background color, and so on) by setting the style properties for the different parts of the field. A tabela a seguir lista as propriedades de estilo diferentes.The following table lists the different style properties.

Propriedade de estiloStyle property DescriçãoDescription
ControlStyle As configurações de estilo para os controles de servidor Web filho do TemplateField objeto.The style settings for the child Web server controls of the TemplateField object.
FooterStyle As configurações de estilo da seção de rodapé do TemplateField objeto.The style settings for the footer section of the TemplateField object.
HeaderStyle As configurações de estilo da seção de cabeçalho do TemplateField objeto.The style settings for the header section of the TemplateField object.
ItemStyle As configurações de estilo para os itens de dados no TemplateField objeto.The style settings for the data items in the TemplateField object.

Construtores

TemplateField()

Inicializa uma nova instância da classe TemplateField.Initializes a new instance of the TemplateField class.

Propriedades

AccessibleHeaderText

Obtém ou define o texto que é renderizado como o valor da propriedade AbbreviatedText em alguns controles.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Herdado de DataControlField)
AlternatingItemTemplate

Obtém ou define o modelo de exibição dos itens alternados em um objeto TemplateField.Gets or sets the template for displaying the alternating items in a TemplateField object.

Control

Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado.Gets a reference to the data control that the DataControlField object is associated with.

(Herdado de DataControlField)
ControlStyle

Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(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.Gets or sets a value indicating whether the value that the TemplateField object is bound to should be converted to null if it is Empty.

DesignMode

Obtém um valor que indica se um campo de controle de dados é atualmente exibido em um ambiente de tempo de design.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Herdado de DataControlField)
EditItemTemplate

Obtém ou define o modelo para exibir um item no modo de edição em um objeto TemplateField.Gets or sets the template for displaying an item in edit mode in a TemplateField object.

FooterStyle

Obtém ou define o estilo do rodapé do campo de controle de dados.Gets or sets the style of the footer of the data control field.

(Herdado de DataControlField)
FooterTemplate

Obtém ou define o modelo para exibir a seção de rodapé de um objeto TemplateField.Gets or sets the template for displaying the footer section of a TemplateField object.

FooterText

Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados.Gets or sets the text that is displayed in the footer item of a data control field.

(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.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Herdado de DataControlField)
HeaderStyle

Obtém ou define o estilo do cabeçalho do campo de controle de dados.Gets or sets the style of the header of the data control field.

(Herdado de DataControlField)
HeaderTemplate

Obtém ou define o modelo para exibir a seção de cabeçalho de um objeto TemplateField.Gets or sets the template for displaying the header section of a TemplateField object.

HeaderText

Obtém ou define o texto exibido no item de cabeçalho de um campo de controle de dados.Gets or sets the text that is displayed in the header item of a data control field.

(Herdado de DataControlField)
InsertItemTemplate

Obtém ou define o modelo para exibir um item no modo de inserção em um objeto TemplateField.Gets or sets the template for displaying an item in insert mode in a TemplateField object.

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.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Herdado de DataControlField)
IsTrackingViewState

Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Herdado de DataControlField)
ItemStyle

Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados.Gets the style of any text-based content displayed by a data control field.

(Herdado de DataControlField)
ItemTemplate

Obtém ou define o modelo para exibir um item em um controle de associação de dados.Gets or sets the template for displaying an item in a data-bound control.

ShowHeader

Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado.Gets or sets a value indicating whether the header item of a data control field is rendered.

(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.Gets or sets a sort expression that is used by a data source control to sort data.

(Herdado de DataControlField)
ValidateRequestMode

Obtém ou define um valor que especifica se o controle valida a entrada do cliente.Gets or sets a value that specifies whether the control validates client input.

ValidateRequestMode

Obtém ou define um valor que especifica se o controle valida a entrada do cliente.Gets or sets a value that specifies whether the control validates client input.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Herdado de DataControlField)
Visible

Obtém ou define um valor que indica se um campo de controle de dados é renderizado.Gets or sets a value indicating whether a data control field is rendered.

(Herdado de DataControlField)

Métodos

CloneField()

Cria uma cópia duplicada do objeto atual derivado de DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

(Herdado de DataControlField)
CopyProperties(DataControlField)

Copia as propriedades do objeto atual derivado de TemplateField para o objeto DataControlField especificado.Copies the properties of the current TemplateField-derived object to the specified DataControlField object.

CreateField()

Cria um novo objeto TemplateField.Creates a new TemplateField object.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(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.Extracts the value of the data control fields as specified by one or more two-way binding statements (DataBind) from the current table cell and adds the values to the specified IOrderedDictionary collection.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
Initialize(Boolean, Control)

Executa a inicialização de instância básica para um campo de controle de dados.Performs basic instance initialization for a data control field.

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

Adiciona texto ou controles à coleção de controles da célula.Adds text or controls to a cell's controls collection.

LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.Restores the data source view's previously saved view state.

(Herdado de DataControlField)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnFieldChanged()

Aciona o evento FieldChanged.Raises the FieldChanged event.

(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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Herdado de DataControlField)
ToString()

Retorna uma cadeia de caracteres que representa este objeto DataControlField.Returns a string that represents this DataControlField object.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Herdado de DataControlField)
ValidateSupportsCallback()

Determina se os controles contidos em um objeto TemplateField dão suporte a retornos de chamada de página.Determines whether the controls contained in a TemplateField object support page callbacks.

Implantações explícitas de interface

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtém ou define o esquema associado a este objeto DataControlField.Gets or sets the schema associated with this DataControlField object.

(Herdado de DataControlField)
IStateManager.IsTrackingViewState

Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Herdado de DataControlField)
IStateManager.LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente do campo de controle de dados.Restores the data control field's previously saved view state.

(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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Herdado de DataControlField)

Aplica-se a

Confira também