TemplateField Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un campo que muestra contenido personalizado en un control enlazado a datos.

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

DataControlField
TemplateField

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un objeto personalizado TemplateField que muestra dos campos en la misma celda. Los campos de nombre y apellidos se combinan en el mismo 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>

Comentarios

Los controles enlazados a datos (como GridView y DetailsView) usan la TemplateField clase para mostrar contenido personalizado para cada registro mostrado. Cuando necesite mostrar contenido en un control enlazado a datos que no proporciona uno de los campos de control de datos predefinidos (como BoundField), use la clase para crear la TemplateField interfaz de usuario (UI) personalizada. El TemplateField objeto se muestra de forma diferente según el control enlazado a datos en el que se use. Por ejemplo, el GridView control muestra un TemplateField objeto como una columna y el DetailsView control lo muestra como una fila.

Puede definir una plantilla personalizada para las distintas partes del TemplateField objeto mediante las plantillas enumeradas en la tabla siguiente.

Plantilla	Descripción
AlternatingItemTemplate	Especifica el contenido que se va a mostrar para los elementos alternativos de un TemplateField objeto .
EditItemTemplate	Especifica el contenido que se va a mostrar para un elemento en modo de edición en un TemplateField objeto .
FooterTemplate	Especifica el contenido que se va a mostrar para la sección de pie de página de un TemplateField objeto .
HeaderTemplate	Especifica el contenido que se va a mostrar para la sección de encabezado de un TemplateField objeto .
InsertItemTemplate	Especifica el contenido que se va a mostrar para un elemento en modo de inserción en un TemplateField objeto . Este control solo DetailsView admite esta plantilla.
ItemTemplate	Especifica el contenido que se va a mostrar para los elementos de un TemplateField objeto .

Puede ocultar un TemplateField objeto en un control enlazado a datos estableciendo la Visible propiedad falseen .

Como alternativa a definir una plantilla o FooterTemplate personalizadaHeaderTemplate, puede personalizar las secciones de encabezado y pie de página de un TemplateField objeto estableciendo otras propiedades del TemplateField objeto. Para mostrar un subtítulo en las secciones de encabezado o pie de página, establezca la HeaderText propiedad o FooterText , respectivamente. En lugar de mostrar texto en la sección de encabezado, puede mostrar una imagen estableciendo la HeaderImageUrl propiedad . La sección de encabezado se puede ocultar en el TemplateField objeto estableciendo la ShowHeader propiedad falseen .

Nota

Algunos controles enlazados a datos (como el GridView control) pueden mostrar u ocultar solo la sección de encabezado completa del control. Estos controles enlazados a datos no admiten la ShowHeader propiedad para un campo enlazado individual. Para mostrar u ocultar toda la sección de encabezado de un control enlazado a datos, use la propiedad del ShowHeader control (si está disponible).

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. En la tabla siguiente se enumeran las diferentes propiedades de estilo.

Propiedad Style	Descripción
ControlStyle	La configuración de estilo para los controles secundarios del servidor web del TemplateField objeto .
FooterStyle	La configuración de estilo de la sección de pie de página del TemplateField objeto.
HeaderStyle	La configuración de estilo de la sección de encabezado del TemplateField objeto.
ItemStyle	La configuración de estilo de los elementos de datos del TemplateField objeto .

Constructores

TemplateField()

Inicializa una nueva instancia de la clase TemplateField.

Propiedades

AccessibleHeaderText	Obtiene o establece el texto que se representa como el valor de la propiedad `AbbreviatedText` en algunos controles. (Heredado de DataControlField)
AlternatingItemTemplate	Obtiene o establece la plantilla para mostrar los elementos alternos en un objeto TemplateField.
Control	Obtiene una referencia al control de datos al que está asociado el objeto DataControlField. (Heredado de DataControlField)
ControlStyle	Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField. (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.
DesignMode	Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño. (Heredado de DataControlField)
EditItemTemplate	Obtiene o establece la plantilla para mostrar un elemento en modo de edición en un objeto TemplateField.
FooterStyle	Obtiene o establece el estilo del pie de página del campo del control de datos. (Heredado de DataControlField)
FooterTemplate	Obtiene o establece la plantilla que permite mostrar la sección de pie de página de un objeto TemplateField.
FooterText	Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos. (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. (Heredado de DataControlField)
HeaderStyle	Obtiene o establece el estilo del encabezado del campo del control de datos. (Heredado de DataControlField)
HeaderTemplate	Obtiene o establece la plantilla que permite mostrar la sección de encabezado de un objeto TemplateField.
HeaderText	Obtiene o establece el texto que se muestra en el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField)
InsertItemTemplate	Obtiene o establece la plantilla para mostrar un elemento en modo de inserción en un objeto TemplateField.
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. (Heredado de DataControlField)
IsTrackingViewState	Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField)
ItemStyle	Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos. (Heredado de DataControlField)
ItemTemplate	Obtiene o establece la plantilla que permite mostrar un elemento en un control enlazado a datos.
ShowHeader	Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos. (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. (Heredado de DataControlField)
ValidateRequestMode	Obtiene o establece un valor que especifica si el control valida la entrada de cliente.
ValidateRequestMode	Obtiene o establece un valor que especifica si el control valida la entrada de cliente. (Heredado de DataControlField)
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. (Heredado de DataControlField)
Visible	Obtiene o establece un valor que indica si se representa un campo de control de datos. (Heredado de DataControlField)

Métodos

CloneField()	Crea una copia duplicada del objeto actual derivado de DataControlField. (Heredado de DataControlField)
CopyProperties(DataControlField)	Copia las propiedades del objeto derivado de TemplateField actual al objeto DataControlField especificado.
CreateField()	Crea un nuevo objeto TemplateField.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (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.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Initialize(Boolean, Control)	Realiza la inicialización de la instancia básica para un campo de control de datos. (Heredado de DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Agrega texto o controles a la colección de controles de una celda.
LoadViewState(Object)	Restaura la vista del origen de datos tal y como se guardó previamente. (Heredado de DataControlField)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnFieldChanged()	Genera el evento `FieldChanged`. (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. (Heredado de DataControlField)
ToString()	Devuelve una cadena que representa este objeto DataControlField. (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. (Heredado de DataControlField)
ValidateSupportsCallback()	Determina si los controles contenidos en un objeto TemplateField admiten devoluciones de llamada de páginas.

Implementaciones de interfaz explícitas

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtiene o establece el esquema asociado a este objeto DataControlField. (Heredado de DataControlField)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField)
IStateManager.LoadViewState(Object)	Restaura el estado de vista que se guardó previamente del campo de control de datos. (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. (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. (Heredado de DataControlField)

Se aplica a

Compartir vía