Schéma d’affichage CAML et XMLDefinition
Dernière modification : jeudi 21 octobre 2010
S’applique à : SharePoint Foundation 2010
La propriété XmlDefinition de XsltListViewWebPart contient l’élément View qui décrit la requête de l’affichage : la liste des champs et leur ordre, les options de tri, de filtrage et de regroupement, ainsi que certains paramètres de style d’affichage déclaratifs.
La propriété XmlDefinition implémente le même schéma que la propriété ListViewXml de la classe ListViewWebPart. Toutefois, à la différence de la classe ListViewWebPart, la classe XsltListViewWebPart ignore tous les éléments de niveau supérieur dans l’affichage qui sont utilisés uniquement pour le rendu HTML. Au lieu d’utiliser les éléments du schéma d’affichage pour le rendu, SharePoint Foundation définit le rendu par le biais des modèles XSLT mis en cache dans la classe XsltListViewWebPart.
La liste suivante répertorie les éléments enfants valides de l’élément View et indique s’ils sont reconnus et analysés par l’objet XsltListViewWebPart quant aux paramètres d’affichage qu’ils contiennent, ou s’ils sont ignorés et remplacés par un rendu XSLT :
Aggregations : reconnu
FieldRef : reconnu
GroupByFooter : ignoré
GroupByHeader : ignoré
PagedClientCallbackRowset : ignoré
PagedRecurrenceRowset : ignoré
PagedRowset : ignoré
Query : reconnu
RowLimit : reconnu
RowLimitExceeded : ignoré
Toolbar : reconnu
ViewBidiHeader : ignoré
ViewBody : ignoré
ViewData : reconnu
FieldRef : reconnu
ViewEmpty : ignoré
ViewFields : reconnu
FieldRef : reconnu
ViewFooter : ignoré
ViewHeader : ignoré
ViewStyle : reconnu
La plupart des éléments « reconnus » définissent la requête qui retourne un ensemble de lignes à l’aide de l’objet SPDataSource. Les données XML obtenues sont ensuite transformées en données XHTML par XSLT. Pour plus d’informations sur la syntaxe XML dsQueryResponse utilisée pour la transformation des données XML, voir Vue d’ensemble du système de rendu des affichages de liste XSLT. Les éléments contenus dans la propriété XmlDefinition (par exemple, l’élément ViewStyle) fournissent des indicateurs déclaratifs sur le rendu qui doit être effectué par XSLT, mais ils ne définissent pas explicitement les schémas ou modèles de rendu. La modification d’un objet XsltListViewWebPart par le biais de l’interface utilisateur SharePoint Foundation modifie uniquement les éléments « reconnus » dans la propriété XmlDefinition du composant WebPart.
XmlDefinition existe également en tant que paramètre global, qui permet de récupérer les paramètres d’affichage à utiliser dans XSLT. Par exemple, <xsl:value-of select = "$XmlDefinition/RowLimit"/> récupère la limite des lignes spécifiée par l’élément RowLimit.
Voir aussi
Concepts
XsltListViewWebPart et affichages de liste personnalisés
Vue d’ensemble du système de rendu d’affichage Liste XSLT
Procédure : implémenter des ressources dans des affichages de liste personnalisés