Partager via


TemplateField Classe

Définition

Représente un champ qui affiche du contenu personnalisé dans un contrôle lié aux données.

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
Héritage
TemplateField

Exemples

L’exemple de code suivant montre comment créer un objet personnalisé TemplateField qui affiche deux champs dans la même cellule. Les champs prénom et nom sont combinés dans le même TemplateField objet.


<%@ 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>

Remarques

La TemplateField classe est utilisée par les contrôles liés aux données (tels que GridView et DetailsView) pour afficher du contenu personnalisé pour chaque enregistrement affiché. Lorsque vous devez afficher du contenu dans un contrôle lié aux données qui n’est pas fourni par l’un des champs de contrôle de données prédéfinis (par exemple BoundField), utilisez la TemplateField classe pour créer votre interface utilisateur personnalisée. L’objet TemplateField est affiché différemment en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le GridView contrôle affiche un TemplateField objet sous forme de colonne et le contrôle l’affiche DetailsView sous forme de ligne.

Vous pouvez définir un modèle personnalisé pour les différentes parties de l’objet à l’aide TemplateField des modèles répertoriés dans le tableau suivant.

Modèle Description
AlternatingItemTemplate Spécifie le contenu à afficher pour les éléments en alternance dans un TemplateField objet.
EditItemTemplate Spécifie le contenu à afficher pour un élément en mode édition dans un TemplateField objet.
FooterTemplate Spécifie le contenu à afficher pour la section pied de page d’un TemplateField objet.
HeaderTemplate Spécifie le contenu à afficher pour la section d’en-tête d’un TemplateField objet.
InsertItemTemplate Spécifie le contenu à afficher pour un élément en mode insertion dans un TemplateField objet. Ce modèle est pris en charge uniquement par le DetailsView contrôle.
ItemTemplate Spécifie le contenu à afficher pour les éléments d’un TemplateField objet.

Vous pouvez masquer un TemplateField objet dans un contrôle lié aux données en définissant la Visible propriété sur false.

En guise d’alternative à la définition d’un modèle ou FooterTemplate d’un modèle personnaliséHeaderTemplate, vous pouvez personnaliser les sections d’en-tête et de pied de page d’un TemplateField objet en définissant d’autres propriétés de l’objetTemplateField. Pour afficher un légende dans les sections d’en-tête ou de pied de page, définissez la HeaderTextFooterText propriété ou, respectivement. Au lieu d’afficher du texte dans la section d’en-tête, vous pouvez afficher une image en définissant la HeaderImageUrl propriété . La section d’en-tête peut être masquée dans l’objet TemplateField en définissant la ShowHeader propriété sur false.

Notes

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement la section d’en-tête entière du contrôle. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété d’un champ lié individuel. Pour afficher ou masquer l’ensemble de la section d’en-tête d’un contrôle lié aux données, utilisez la propriété du ShowHeader contrôle (si disponible).

Vous pouvez également personnaliser l’apparence de l’objet TemplateField (couleur de police, couleur d’arrière-plan, etc.) en définissant les propriétés de style pour les différentes parties du champ. Le tableau suivant répertorie les différentes propriétés de style.

Propriété Style Description
ControlStyle Paramètres de style pour les contrôles serveur Web enfants de l’objet TemplateField .
FooterStyle Paramètres de style pour la section pied de page de l’objet TemplateField .
HeaderStyle Paramètres de style pour la section d’en-tête de l’objet TemplateField .
ItemStyle Paramètres de style pour les éléments de données de l’objet TemplateField .

Constructeurs

TemplateField()

Initialise une nouvelle instance de la classe TemplateField.

Propriétés

AccessibleHeaderText

Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles.

(Hérité de DataControlField)
AlternatingItemTemplate

Obtient ou définit le modèle pour afficher les éléments de remplacement dans un objet TemplateField.

Control

Obtient une référence au contrôle de données auquel l'objet DataControlField est associé.

(Hérité de DataControlField)
ControlStyle

Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField.

(Hérité de DataControlField)
ConvertEmptyStringToNull

Obtient ou définit une valeur indiquant si la valeur à laquelle l'objet TemplateField est lié doit être convertie en null si elle est Empty.

DesignMode

Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.

(Hérité de DataControlField)
EditItemTemplate

Obtient ou définit le modèle pour afficher un élément en mode édition dans un objet TemplateField.

FooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.

(Hérité de DataControlField)
FooterTemplate

Obtient ou définit le modèle utilisé pour afficher le pied de page d'un objet TemplateField.

FooterText

Obtient ou définit le texte affiché dans l'élément de pied de page d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderImageUrl

Obtient ou définit l'URL d'une image affichée dans l'élément d'en-tête d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderStyle

Obtient ou définit le style de l'en-tête du champ de contrôle de données.

(Hérité de DataControlField)
HeaderTemplate

Obtient ou définit le modèle utilisé pour afficher le pied de page d'un objet TemplateField.

HeaderText

Obtient ou définit le texte affiché dans l'élément d'en-tête d'un champ de contrôle de données.

(Hérité de DataControlField)
InsertItemTemplate

Obtient ou définit le modèle pour afficher un élément en mode insertion dans un objet TemplateField.

InsertVisible

Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion.

(Hérité de DataControlField)
IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
ItemStyle

Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données.

(Hérité de DataControlField)
ItemTemplate

Obtient ou définit le modèle pour afficher un élément dans un contrôle lié aux données.

ShowHeader

Obtient ou définit une valeur indiquant si l'élément d'en-tête d'un champ de contrôle de données est restitué.

(Hérité de DataControlField)
SortExpression

Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier des données.

(Hérité de DataControlField)
ValidateRequestMode

Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client.

ValidateRequestMode

Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client.

(Hérité de DataControlField)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataControlField entre plusieurs demandes de la même page.

(Hérité de DataControlField)
Visible

Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué.

(Hérité de DataControlField)

Méthodes

CloneField()

Crée une copie de l'objet dérivé de DataControlField en cours.

(Hérité de DataControlField)
CopyProperties(DataControlField)

Copie les propriétés de l'objet dérivé de TemplateField actuel vers l'objet DataControlField spécifié.

CreateField()

Crée un objet TemplateField.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrait la valeur des champs de contrôle de données comme spécifié par une ou plusieurs instructions de liaison bidirectionnelle (DataBind) de la cellule de table actuelle et ajoute les valeurs à la collection IOrderedDictionary spécifiée.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
Initialize(Boolean, Control)

Effectue l'initialisation d'instance de base pour un champ de contrôle de données.

(Hérité de DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Ajoute du texte ou des contrôles à la collection de contrôles d'une cellule.

LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.

(Hérité de DataControlField)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnFieldChanged()

Déclenche l’événement FieldChanged.

(Hérité de DataControlField)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
ToString()

Retourne une chaîne qui représente cet objet DataControlField.

(Hérité de DataControlField)
TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)
ValidateSupportsCallback()

Détermine si les contrôles contenus dans un objet TemplateField prennent en charge les rappels de page.

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtient ou définit le schéma associé à cet objet DataControlField.

(Hérité de DataControlField)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données.

(Hérité de DataControlField)
IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
IStateManager.TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)

S’applique à

Voir aussi