TemplateField Classe

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

DataControlField
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 BoundFieldexemple), 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 DetailsView contrôle l’affiche sous forme de ligne.

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

Template	Description
AlternatingItemTemplate	Spécifie le contenu à afficher pour les éléments alternés 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 d’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 propriété sur falseVisible .

En guise d’alternative à la définition d’un modèle ou 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.FooterTemplate Pour afficher une légende dans les sections d’en-tête ou de pied de page, définissez la HeaderText ou la FooterText propriété, 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.

Note

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’intégralité de la section d’en-tête d’un contrôle lié aux données, utilisez la propriété du ShowHeader contrôle (le cas échéant).

Vous pouvez également personnaliser l’apparence de l’objet TemplateField (couleur de police, couleur d’arrière-plan, et ainsi de suite) 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.

Style, propriété	Description
ControlStyle	Paramètres de style pour les contrôles de serveur Web enfant de l’objet TemplateField .
FooterStyle	Paramètres de style de la section pied de page de l’objet TemplateField .
HeaderStyle	Paramètres de style de 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

Nom	Description
TemplateField()	Initialise une nouvelle instance de la classe TemplateField.

Propriétés

Nom	Description
AccessibleHeaderText	Obtient ou définit le `AbbreviatedText` texte qui est rendu en tant que valeur de propriété dans certains contrôles. (Hérité de DataControlField)
AlternatingItemTemplate	Obtient ou définit le modèle pour afficher les éléments alternés dans un TemplateField objet.
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 tous les contrôles de serveur Web contenus par 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 `null` si elle est Empty.
DesignMode	Obtient une valeur indiquant si un champ de contrôle de données est actuellement consulté dans un environnement au moment du design. (Hérité de DataControlField)
EditItemTemplate	Obtient ou définit le modèle pour l’affichage d’un élément en mode édition dans un TemplateField objet.
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 pour afficher la section pied de page d’un TemplateField objet.
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 pour afficher la section d’en-tête d’un TemplateField objet.
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 l’affichage d’un élément en mode d’insertion dans un TemplateField objet.
InsertVisible	Obtient une valeur indiquant si l’objet DataControlField est visible lorsque son contrôle parent lié aux données est en mode d’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 d’un contenu textuel affiché par un champ de contrôle de données. (Hérité de DataControlField)
ItemTemplate	Obtient ou définit le modèle pour l’affichage d’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 rendu. (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 les 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.
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un DataControlField objet sur plusieurs requêtes pour 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 rendu. (Hérité de DataControlField)

Méthodes

Nom	Description
CloneField()	Crée une copie en double de l’objet dérivé actuel DataControlField. (Hérité de DataControlField)
CopyProperties(DataControlField)	Copie les propriétés de l’objet dérivé actuel TemplateFieldvers l’objet spécifié DataControlField .
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 active et ajoute les valeurs à la collection spécifiée IOrderedDictionary .
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la 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 précédemment enregistré de la vue de source de données. (Hérité de DataControlField)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnFieldChanged()	Déclenche l’événement `FieldChanged`. (Hérité de DataControlField)
SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage depuis la publication de la page sur le serveur. (Hérité de DataControlField)
ToString()	Retourne une chaîne qui représente cet DataControlField objet. (Hérité de DataControlField)
TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataControlField)
ValidateSupportsCallback()	Détermine si les contrôles contenus dans un rappel de page de prise en charge d’objet TemplateField .

Implémentations d’interfaces explicites

Nom	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtient ou définit le schéma associé à cet DataControlField objet. (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 précédemment enregistré du champ de contrôle de données. (Hérité de DataControlField)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage depuis la publication de la page sur le serveur. (Hérité de DataControlField)
IStateManager.TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataControlField)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?