Options de sortie de la classe XslCompiledTransform
Cet article présente les options de sortie XSLT disponibles. Vous pouvez spécifier des options de sortie dans la feuille de style ou dans la méthode Transform.
Élément xsl:output
L'élément xsl:output spécifie des options de sortie. Le type de sortie spécifié par la méthode Transform détermine le comportement des options xsl:output.
Le tableau suivant décrit le comportement de chacun des attributs disponibles dans l'élément xsl:output lorsque le type de sortie est un flux ou un objet TextWriter.
| Nom de l’attribut | Comportement |
|---|---|
| method | Pris en charge. |
| version | Ignoré. La version est toujours 1.0 pour XML et 4.0 pour HTML. |
| encodage | Ignoré en cas de sortie vers un objet TextWriter. La propriété TextWriter.Encoding est utilisée à la place. |
| omit-xml-declaration | Pris en charge. |
| autonomes | Pris en charge. |
| doctype-public | Pris en charge. |
| doctype-system | Pris en charge. |
| cdata-section-elements | Pris en charge. |
| indent | Pris en charge. |
| media-type | Pris en charge. |
Envoi de la sortie vers un XmlWriter
Si votre feuille de style utilise l'élément xsl:output et que le type de sortie est un objet XmlWriter, utilisez la propriété XslCompiledTransform.OutputSettings lorsque vous créez l'objet XmlWriter. La propriété XslCompiledTransform.OutputSettings retourne un objet XmlWriterSettings contenant des informations dérivées de l'élément xsl:output d'une feuille de style compilée. Cet objet XmlWriterSettings peut être transféré à la méthode XmlWriter.Create pour créer un objet XmlWriter avec les paramètres corrects.
Types de sortie
La liste suivante décrit les types de sortie disponibles avec la commande Transform.
XmlWriter
La classe XmlWriter produit des fichiers ou des flux XML. Vous pouvez spécifier les fonctionnalités à prendre en charge dans l’objet XmlWriter, y compris les options de sortie, en utilisant la classe XmlWriterSettings. La classe XmlWriter fait partie intégrante de l'infrastructure System.Xml. Utilisez ce type de sortie pour envoyer les résultats vers un autre processus XML via un pipeline.
String
Utilisez ce type de sortie pour spécifier l'URI du fichier de sortie.
Stream
Un flux est une abstraction d'une séquence d'octets, comme un fichier, un appareil d'entrée/sortie, un canal de communication inter-processus ou un socket TCP/IP. La classe Stream et ses classes dérivées donnent une vue générique de ces différents types d'entrée et de sortie, isolant ainsi le programmeur des détails propres au système d'exploitation et aux périphériques sous-jacents.
Utilisez ce type de sortie pour envoyer des données à un objet FileStream, à un objet MemoryStream ou à un flux de sortie (Response.OutputStream).
TextWriter
L'objet TextWriter produit des caractères séquentiels. Il est implémenté dans les classes StringWriter et StreamWriter, qui écrivent des caractères dans des chaînes ou des flux, respectivement. Utilisez ce type de sortie lorsque vous souhaitez envoyer la sortie vers une chaîne.
Notes
Lorsque vous écrivez des chaînes vides, un espace est inséré entre le dernier caractère du nom de l'élément et la barre oblique inverse, par exemple <myElement />. Cela permet aux anciens navigateurs d'afficher correctement les pages HTML générées.
