Objets d'extension XSLT

Les objets d’extension permettent d’étendre les fonctionnalités des feuilles de style. Ils sont gérés par la classe XsltArgumentList.

L’utilisation d’un objet d’extension plutôt que d’un script intégré présente les avantages suivants :

  • Offre une meilleure encapsulation et réutilisation des classes.

  • Permet aux feuilles de styles d'être plus petites et plus faciles à gérer.

Des objets d’extension XSLT sont ajoutés à l’objet XsltArgumentList à l’aide de la méthode AddExtensionObject. Un nom qualifié et un URI d'espace de noms sont associés à l'objet d'extension à ce stade.

Notes

Le jeu d'autorisations FullTrust est requis pour appeler la méthode AddExtensionObject. Pour plus d’informations, consultez les pages Sécurité d’accès du code et Jeux d’autorisations nommés.

Les types de données retournés par les objets d’extension correspondent à l’un des quatre types de données de base XPath : number, string, Boolean et node set.

Les méthodes définies avec le mot clé params, qui permet de transmettre un nombre non spécifié de paramètres, ne sont actuellement pas prises en charge par la classe XslCompiledTransform. Les feuilles de style XSLT qui utilisent une méthode définie avec le mot clé params ne fonctionnent pas correctement. Pour plus d’informations, consultez la page params.

Pour utiliser un objet d’extension XSLT

  1. Créez un objet XsltArgumentList et ajoutez l'objet d'extension à l'aide de la méthode AddExtensionObject.

  2. Appelez l’objet d’extension à partir de la feuille de style.

  3. Transmettez l'objet XsltArgumentList à la méthode Transform.

Voir aussi