Migration depuis la classe XslTransform
Mise à jour : November 2007
L'architecture XSLT a été repensée dans la version de Visual Studio 2005. La classe XslTransform a été remplacée par la classe XslCompiledTransform.
Les sections suivantes décrivent quelques-unes des principales différences entre les classes XslCompiledTransform et XslTransform.
Performances
La classe XslCompiledTransform comporte de nombreuses améliorations des performances. Le nouveau processeur XSLT compile la feuille de style XSLT en un format intermédiaire commun, à la façon dont le CLR (common language runtime) le fait pour d'autres langages de programmation. Une fois compilée, la feuille de style peut être mise en cache et réutilisée.
La classe XslCompiledTransform inclut aussi d'autres optimisations qui la rendent beaucoup plus rapide que la classe XslTransform.
Sécurité
Par défaut, la classe XslCompiledTransform désactive la prise en charge de la fonction XSLT document() et les scripts intégrés par défaut. Ces fonctions peuvent être activées en créant un objet XsltSettings où les fonctions sont activées et en le passant à la méthode Load. L'exemple suivant montre comment activer les scripts et effectuer une transformation XSLT.
' Create the XsltSettings object with script enabled.
Dim settings As New XsltSettings(False, True)
' Execute the transform.
Dim xslt As New XslCompiledTransform()
xslt.Load("calc.xsl", settings, New XmlUrlResolver())
xslt.Transform("books.xml", "books.html")
// Create the XsltSettings object with script enabled.
XsltSettings settings = new XsltSettings(false,true);
// Execute the transform.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("calc.xsl", settings, new XmlUrlResolver());
xslt.Transform("books.xml", "books.html");
Pour plus d'informations, voir XSLT et la sécurité.
Nouvelles fonctionnalités
Fichiers temporaires
Des fichiers temporaires sont parfois générés au cours du traitement XSLT. Si une feuille de style contient des blocs de script, ou si elle est compilée avec le paramètre de débogage défini sur true, des fichiers temporaires peuvent être créés dans le dossier %TEMP%. Certains fichiers temporaires ne sont pas supprimés à cause de problèmes de synchronisation. Par exemple, si les fichiers sont utilisés par le AppDomain en cours ou par le débogueur, le finaliseur de l'objet TempFileCollection ne pourra pas les supprimer.
La propriété TemporaryFiles peut être utilisée pour un nettoyage supplémentaire afin de s'assurer que tous les fichiers temporaires sont supprimés du client.
Prise en charge de l'élément xsl:output et de XmlWriter
La classe XslTransform a ignoré les paramètres xsl:output lorsque la sortie de transformation a été envoyée à un objet XmlWriter. La classe XslCompiledTransform a une propriété OutputSettings qui retourne un objet XmlWriterSettings contenant les informations de sortie dérivées de l'élément xsl:output de la feuille de style. L'objet XmlWriterSettings est utilisé pour créer un objet XmlWriter avec les paramètres corrects qui peut être passé à la méthode Transform. Le code C# suivant illustre ce comportement :
// Create the XslTransform object and load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load(stylesheet);
// Load the file to transform.
XPathDocument doc = new XPathDocument(filename);
// Create the writer.
XmlWriter writer = XmlWriter.Create(Console.Out, xslt.OutputSettings);
// Transform the file and send the output to the console.
xslt.Transform(doc, writer);
writer.Close();
Option de débogage
La classe XslCompiledTransform peut générer des informations de débogage, ce qui vous permet de déboguer la feuille de style à l'aide du Débogueur Microsoft Visual Studio. Pour plus d'informations, voir XslCompiledTransform(Boolean).
Différences comportementales
Transformation vers un XmlReader
La classe XslTransform possède plusieurs surcharges Transform qui retournent des résultats de transformation sous forme d'objet XmlReader. Ces surcharges peuvent être utilisées pour charger les résultats de transformation dans une représentation en mémoire (telle que XmlDocument ou XPathDocument) sans subir la charge de sérialisation et de désérialisation de l'arborescence XML résultante. Le code C# suivant montre comment charger les résultats de transformation dans un objet XmlDocument.
// Load the style sheet
XslTransform xslt = new XslTransform();
xslt.Load("MyStylesheet.xsl");
// Transform input document to XmlDocument for additional processing
XmlDocument doc = new XmlDocument();
doc.Load(xslt.Transform(input, (XsltArgumentList)null));
La classe XslCompiledTransform ne prend pas en charge la transformation vers un objet XmlReader. Vous pouvez cependant effectuer une opération similaire en utilisant la méthode CreateNavigator pour charger directement l'arborescence XML résultante à partir d'un XmlWriter. Le code C# suivant montre comment exécuter la même tâche à l'aide de XslCompiledTransform.
// Transform input document to XmlDocument for additional processing
XmlDocument doc = new XmlDocument();
using (XmlWriter writer = doc.CreateNavigator().AppendChild()) {
xslt.Transform(input, (XsltArgumentList)null, writer);
}
Comportement discrétionnaire
La recommandation du W3C sur XSLT (XSL Transformations) Version 1.0 comprend des zones dans lesquelles le fournisseur d'implémentation peut décider de la manière de gérer une situation. Ces zones sont considérées comme discrétionnaires en termes de comportement. Il existe plusieurs domaines où le XslCompiledTransform se comporte différemment de la classe XslTransform. Pour plus d'informations, voir Erreurs XSLT récupérables.
Objets d'extension et fonctions de script
XslCompiledTransform introduit deux nouvelles restrictions sur l'utilisation des fonctions de script :
Seules les méthodes publiques peuvent être appelées à partir des expressions XPath.
Il est possible de différencier les surcharges en fonction du nombre d'arguments. Si plusieurs surcharges ont le même nombre d'arguments, une exception est levée.
Dans XslCompiledTransform, une liaison (recherche de nom de méthode) vers des fonctions de script se produit au moment de la compilation, et les feuilles de style qui fonctionnaient avec XslTranform peuvent déclencher une exception lorsqu'elles sont chargées avec XslCompiledTransform.
XslCompiledTransform accepte la présence d'éléments enfants msxsl:using et msxsl:assembly dans l'élément msxsl:script. Les éléments msxsl:using et msxsl:assembly sont utilisés pour déclarer des espaces de noms et des assemblys supplémentaires pour une utilisation dans le bloc de script. Pour plus d'informations, voir Blocs de scripts utilisant msxsl:script.
XslCompiledTransform interdit les objets d'extension qui ont plusieurs surcharges avec le même nombre d'arguments.
Fonctions MSXML
La prise en charge de fonctions MSXML supplémentaires a été ajoutée à la classe XslCompiledTransform. La liste suivante décrit les fonctionnalités nouvelles ou améliorées :
msxsl:node-set :XslTransform a nécessité que l'argument de la fonction Fonction node-set soit un fragment d'arborescence résultat. La classe XslCompiledTransform n'impose pas cette exigence.
msxsl:version : cette fonction est prise en charge dans XslCompiledTransform.
Fonctions d'extension Xpath : les fonctions Fonction ms:string-compare, Fonction ms:utc, Fonction ms:namespace-uri, Fonction ms:local-name, Fonction ms:number, Fonction ms:format-date et Fonction ms:format-time sont à présent prises en charge.
Fonctions d'extension Xpath liées au schéma : ces fonctions ne sont pas prises en charge en natif par XslCompiledTransform. Toutefois, elles peuvent être implémentées en tant que fonctions d'extension.