Modèles de rendu de champ

Windows SharePoint Services 3

Un modèle de rendu de champ est un objet RenderingTemplate défini en tant qu'élément RenderingTemplate dans un fichier .ascx du dossier C:\program files\common files\microsoft shared\web server extensions\12\template\controltemplates. Conjointement avec la méthode CreateChildControls d'une classe de contrôle de rendu, il permet d'afficher un champ dans les modes Nouveau ou Modifier et parfois en mode Affichage.

Rapport entre les modèles de rendu et les contrôles de rendu

Un objet RenderingTemplateest un type d'objet Control- ITemplate hybride. Il dérive de Control et ajoute un seul nouveau membre : une propriété Template qui contient un objet ITemplate. Cela permet à un contrôle de rendu (dérivé de TemplateBasedControl) de référencer des objets ITemplate indirectement en référençant un objet RenderingTemplate d'après l'ID de propriété du modèle de rendu (ID)). Le contrôle de rendu peut effectuer cette opération à l'aide d'une ou de plusieurs des propriétés String dont il dispose, telles que TemplateName, qui peut contenir l'ID d'un modèle de rendu.

Système du modèle de rendu

À chaque contrôle de rendu de champ est associé au moins un modèle de rendu de champ. Au moment du rendu, Windows SharePoint Services 3.0 recherche le modèle nécessaire d'après les ID de tous les contrôles déclarés dans les fichiers .ascx du dossier C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES (tous chargés au démarrage de l'application Web).

Configuration du rendu des champs

De nombreuses options vous permettent de contrôler avec précision le rendu des champs personnalisés à l'aide de modèles de rendu de champ. Cette rubrique décrit uniquement la configuration la plus courante. Pour plus d'informations sur les autres options de rendu, voir Schémas de rendu de champ personnalisé.

Le schéma de la configuration du rendu des champs que vous serez amené à utiliser le plus souvent lors du développement de types de champs personnalisés présente les caractéristiques suivantes :

  • Le contrôle de rendu est associé à un seul modèle de rendu et utilise sa propriété TemplateName pour spécifier l'ID du modèle.

  • Ce seul modèle assure la majeure partie du rendu des champs en modes Nouveau et Modifier. (Le rendu en mode Affichage est généralement géré par un schéma de rendu défini dans une définition de champ.)

  • La méthode CreateChildControls du contrôle de rendu affecte des valeurs par défaut aux contrôles enfants du contrôle de rendu en mode Nouveau. Elle affecte les valeurs actuelles du champ aux contrôles enfants en mode édition. (Elle n'effectue aucune opération en mode Affichage.) En outre, elle peut réaliser des tâches de rendu finales telles que l'affectation d'une classe CSS à un contrôle Label enfant.

  • La logique de validation est implémentée par les membres Validate, IsValid et ErrorMessage du contrôle de rendu de champ et par la méthode GetValidatedString du type de champ sous-jacent. (Validate peut être appelé par CreateChildControls.)

BaseFieldControl hérite de TemplateBasedControl et des membres FieldMetadata qui lui permettent d'être lié à plusieurs modèles de rendu et de basculer de l'un à l'autre en fonction du contexte de rendu. Pour plus d'informations sur les autres schémas de rendu des champs, voir Schémas de rendu de champ personnalisé.

Voir aussi

Afficher: