TemplateField Clase

Definición

Representa un campo que muestra contenido personalizado en un control enlazado a datos.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
Herencia
TemplateField

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear TemplateField un objeto personalizado que muestra dos campos en la misma celda.The following code example demonstrates how to create a custom TemplateField object that displays two fields in the same cell. Los campos de nombre y apellidos se combinan en el mismo 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>

Comentarios

Los TemplateField controles enlazados a datos ( GridView como y DetailsView) utilizan la clase para mostrar el contenido personalizado de cada registro que se muestra.The TemplateField class is used by data-bound controls (such as GridView and DetailsView) to display custom content for each record displayed. Si necesita mostrar contenido en un control enlazado a datos que no se proporciona mediante uno de los campos de control de datos predefinidos ( BoundFieldcomo), use TemplateField la clase para crear la interfaz de usuario (UI) 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). El TemplateField objeto se muestra de forma diferente en función del control enlazado a datos en el que se utiliza.The TemplateField object is displayed differently depending on the data-bound control in which it is used. Por ejemplo, el GridView control muestra un TemplateField objeto como una columna y el DetailsView control lo muestra como una fila.For example, the GridView control displays a TemplateField object as a column, and the DetailsView control displays it as a row.

Puede definir una plantilla personalizada para las distintas partes del TemplateField objeto utilizando las plantillas que se muestran en la tabla siguiente.You can define a custom template for the different parts of the TemplateField object using the templates listed in the following table.

PlantillaTemplate DescripciónDescription
AlternatingItemTemplate Especifica el contenido que se va a mostrar para los elementos alternos en un TemplateField objeto.Specifies the content to display for the alternating items in a TemplateField object.
EditItemTemplate Especifica el contenido que se va a mostrar para un elemento en modo TemplateField de edición en un objeto.Specifies the content to display for an item in edit mode in a TemplateField object.
FooterTemplate Especifica el contenido que se va a mostrar para la sección de TemplateField pie de página de un objeto.Specifies the content to display for the footer section of a TemplateField object.
HeaderTemplate Especifica el contenido que se va a mostrar para la sección TemplateField de encabezado de un objeto.Specifies the content to display for the header section of a TemplateField object.
InsertItemTemplate Especifica el contenido que se va a mostrar para un elemento en modo TemplateField de inserción en un objeto.Specifies the content to display for an item in insert mode in a TemplateField object. Esta plantilla solo es compatible con el DetailsView control.This template is supported only by the DetailsView control.
ItemTemplate Especifica el contenido que se va a mostrar para los TemplateField elementos de un objeto.Specifies the content to display for the items in a TemplateField object.

Puede ocultar un TemplateField objeto en un control enlazado a datos estableciendo la Visible propiedad en false.You can hide a TemplateField object in a data-bound control by setting the Visible property to false.

Como alternativa a la definición de una HeaderTemplate plantilla FooterTemplate o personalizada, puede personalizar las secciones de encabezado y pie de página TemplateField de un objeto estableciendo otras propiedades del 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 mostrar un título en las secciones de encabezado o de pie de página HeaderText , establezca FooterText la propiedad o, respectivamente.To display a caption in the header or footer sections, set the HeaderText or the FooterText property, respectively. En lugar de mostrar texto en la sección de encabezado, puede mostrar una imagen estableciendo la HeaderImageUrl propiedad.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. La sección de encabezado se puede ocultar en TemplateField el objeto estableciendo la ShowHeader propiedad en false.The header section can be hidden in the TemplateField object by setting the ShowHeader property to false.

Nota

Algunos controles enlazados a datos (como el GridView control) pueden mostrar u ocultar solo la sección de encabezado completa del control.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Estos controles enlazados a datos no admiten ShowHeader la propiedad para un campo enlazado individual.These data-bound controls do not support the ShowHeader property for an individual bound field. Para mostrar u ocultar toda la sección de encabezado de un control enlazado a datos, use la ShowHeader propiedad del control (si está disponible).To show or hide the entire header section of a data-bound control, use the control's ShowHeader property (if available).

También puede personalizar la apariencia del TemplateField objeto (color de fuente, color de fondo, etc.) estableciendo las propiedades de estilo para las distintas partes del 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. En la tabla siguiente se enumeran las distintas propiedades de estilo.The following table lists the different style properties.

Propiedad de estiloStyle property DescripciónDescription
ControlStyle La configuración de estilo para los controles de servidor Web secundarios TemplateField del objeto.The style settings for the child Web server controls of the TemplateField object.
FooterStyle La configuración de estilo de la sección de pie de TemplateField página del objeto.The style settings for the footer section of the TemplateField object.
HeaderStyle La configuración de estilo para la sección de encabezado TemplateField del objeto.The style settings for the header section of the TemplateField object.
ItemStyle La configuración de estilo para los elementos de datos TemplateField en el objeto.The style settings for the data items in the TemplateField object.

Constructores

TemplateField()

Inicializa una nueva instancia de la clase TemplateField.Initializes a new instance of the TemplateField class.

Propiedades

AccessibleHeaderText

Obtiene o establece el texto que se representa como el valor de la propiedad AbbreviatedText en algunos controles.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Heredado de DataControlField)
AlternatingItemTemplate

Obtiene o establece la plantilla para mostrar los elementos alternos en un objeto TemplateField.Gets or sets the template for displaying the alternating items in a TemplateField object.

Control

Obtiene una referencia al control de datos al que está asociado el objeto DataControlField.Gets a reference to the data control that the DataControlField object is associated with.

(Heredado de DataControlField)
ControlStyle

Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(Heredado de DataControlField)
ConvertEmptyStringToNull

Obtiene o establece un valor que indica si el valor al que está enlazado el objeto TemplateField debe convertirse a null si es 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

Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Heredado de DataControlField)
EditItemTemplate

Obtiene o establece la plantilla para mostrar un elemento en modo de edición en un objeto TemplateField.Gets or sets the template for displaying an item in edit mode in a TemplateField object.

FooterStyle

Obtiene o establece el estilo del pie de página del campo del control de datos.Gets or sets the style of the footer of the data control field.

(Heredado de DataControlField)
FooterTemplate

Obtiene o establece la plantilla que permite mostrar la sección de pie de página de un objeto TemplateField.Gets or sets the template for displaying the footer section of a TemplateField object.

FooterText

Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos.Gets or sets the text that is displayed in the footer item of a data control field.

(Heredado de DataControlField)
HeaderImageUrl

Obtiene o establece la dirección URL de una imagen que se muestra en el elemento de encabezado de un campo de control de datos.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Heredado de DataControlField)
HeaderStyle

Obtiene o establece el estilo del encabezado del campo del control de datos.Gets or sets the style of the header of the data control field.

(Heredado de DataControlField)
HeaderTemplate

Obtiene o establece la plantilla que permite mostrar la sección de encabezado de un objeto TemplateField.Gets or sets the template for displaying the header section of a TemplateField object.

HeaderText

Obtiene o establece el texto que se muestra en el elemento de encabezado de un campo de control de datos.Gets or sets the text that is displayed in the header item of a data control field.

(Heredado de DataControlField)
InsertItemTemplate

Obtiene o establece la plantilla para mostrar un elemento en modo de inserción en un objeto TemplateField.Gets or sets the template for displaying an item in insert mode in a TemplateField object.

InsertVisible

Obtiene un valor que indica si el objeto DataControlField está visible cuando su control enlazado a datos primario está en modo de inserción.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Heredado de DataControlField)
IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Heredado de DataControlField)
ItemStyle

Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos.Gets the style of any text-based content displayed by a data control field.

(Heredado de DataControlField)
ItemTemplate

Obtiene o establece la plantilla que permite mostrar un elemento en un control enlazado a datos.Gets or sets the template for displaying an item in a data-bound control.

ShowHeader

Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Heredado de DataControlField)
SortExpression

Obtiene o establece una expresión de ordenación utilizada por un control de origen de datos para ordenar los datos.Gets or sets a sort expression that is used by a data source control to sort data.

(Heredado de DataControlField)
ValidateRequestMode

Obtiene o establece un valor que especifica si el control valida la entrada de cliente.Gets or sets a value that specifies whether the control validates client input.

ViewState

Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataControlField en las distintas solicitudes de la misma 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.

(Heredado de DataControlField)
Visible

Obtiene o establece un valor que indica si se representa un campo de control de datos.Gets or sets a value indicating whether a data control field is rendered.

(Heredado de DataControlField)

Métodos

CloneField()

Crea una copia duplicada del objeto actual derivado de DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

(Heredado de DataControlField)
CopyProperties(DataControlField)

Copia las propiedades del objeto derivado de TemplateField actual al objeto DataControlField especificado.Copies the properties of the current TemplateField-derived object to the specified DataControlField object.

CreateField()

Crea un nuevo objeto TemplateField.Creates a new TemplateField object.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Extrae el valor de los campos del control de datos, según se especifica en una o varias instrucciones de enlace bidireccional (DataBind), de la celda de la tabla actual y agrega sus valores a la colección 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()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
Initialize(Boolean, Control)

Realiza la inicialización de la instancia básica para un campo de control de datos.Performs basic instance initialization for a data control field.

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

Agrega texto o controles a la colección de controles de una celda.Adds text or controls to a cell's controls collection.

LoadViewState(Object)

Restaura la vista del origen de datos tal y como se guardó previamente.Restores the data source view's previously saved view state.

(Heredado de DataControlField)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnFieldChanged()

Genera el evento FieldChanged.Raises the FieldChanged event.

(Heredado de DataControlField)
SaveViewState()

Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Heredado de DataControlField)
ToString()

Devuelve una cadena que representa este objeto DataControlField.Returns a string that represents this DataControlField object.

(Heredado de DataControlField)
TrackViewState()

Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma 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.

(Heredado de DataControlField)
ValidateSupportsCallback()

Determina si los controles contenidos en un objeto TemplateField admiten devoluciones de llamada de páginas.Determines whether the controls contained in a TemplateField object support page callbacks.

Implementaciones de interfaz explícitas

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtiene o establece el esquema asociado a este objeto DataControlField.Gets or sets the schema associated with this DataControlField object.

(Heredado de DataControlField)
IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Heredado de DataControlField)
IStateManager.LoadViewState(Object)

Restaura el estado de vista que se guardó previamente del campo de control de datos.Restores the data control field's previously saved view state.

(Heredado de DataControlField)
IStateManager.SaveViewState()

Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Heredado de DataControlField)
IStateManager.TrackViewState()

Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma 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.

(Heredado de DataControlField)

Se aplica a

Consulte también: