Ausgabeoptionen für die XslCompiledTransform-Klasse
In diesem Artikel finden Sie Informationen zu den verfügbaren XSLT-Ausgabeoptionen. Sie können Ausgabeoptionen im Stylesheet oder in der Transform-Methode angeben.
xsl:output-Element
Mit dem xsl:output-Element werden die Ausgabeoptionen angegeben. Mit dem von der Transform-Methode angegebenen Ausgabetyp wird das Verhalten der xsl:output-Optionen bestimmt.
In der folgenden Tabelle wird das Verhalten der einzelnen im xsl:output-Element verfügbaren Attribute beschrieben, wenn der Ausgabetyp ein Datenstream oder ein TextWriter ist.
| Attributname | Verhalten |
|---|---|
| Methode | Unterstützt. |
| Version | Ignoriert. Diese Version ist immer 1.0 für XML und 4.0 für HTML. |
| encoding | Wird bei Ausgabe in einen TextWriter ignoriert. Stattdessen wird die TextWriter.Encoding-Eigenschaft verwendet. |
| omit-xml-declaration | Unterstützt. |
| Eigenständig | Unterstützt. |
| doctype-public | Unterstützt. |
| doctype-system | Unterstützt. |
| cdata-section-elements | Unterstützt. |
| indent | Unterstützt. |
| media-type | Unterstützt. |
Senden der Ausgabe an einen XmlWriter
Wenn das Stylesheet das xsl:output-Element verwendet und der Ausgabetyp ein XmlWriter-Objekt ist, müssen Sie zum Erstellen des XslCompiledTransform.OutputSettings-Objekts die XmlWriter-Eigenschaft verwenden. Die XslCompiledTransform.OutputSettings-Eigenschaft gibt ein XmlWriterSettings-Objekt mit Informationen zurück, die aus dem xsl:output-Element eines kompilierten Stylesheets abgeleitet wurden. Dieses XmlWriterSettings-Objekt kann an die XmlWriter.Create-Methode übergeben werden, um ein XmlWriter-Objekt mit den ordnungsgemäßen Einstellungen zu erstellen.
Ausgabetypen
In der folgenden Liste sind die über den Transform-Befehl verfügbaren Ausgabetypen beschrieben.
XmlWriter
Die XmlWriter-Klasse schreibt XML-Datenströme oder XML-Dateien aus. Sie können die Funktionen angegeben, die vom XmlWriter-Objekt unterstützt werden sollen, einschließlich der Ausgabeoptionen, indem Sie die XmlWriterSettings-Klasse verwenden. Die XmlWriter-Klasse ist ein integraler Bestandteil des System.Xml-Framework. Verwenden Sie diesen Ausgabetyp, um Ausgabeergebnisse in einen anderen XML-Prozess weiterzuleiten.
Zeichenfolge
Verwenden Sie diesen Ausgabetyp, um den URI der Ausgabedatei anzugeben.
Stream
Ein Stream (Datenstream) ist eine Abstraktion einer Folge von Bytes, beispielsweise eine Datei, ein Eingabe-/Ausgabegerät, eine Pipe für die Kommunikation zwischen Prozessen oder ein TCP/IP-Socket. Die Stream-Klasse und die davon abgeleiteten Klassen stellen eine allgemeine Ansicht dieser unterschiedlichen Eingabe- und Ausgabetypen bereit, sodass Programmierer sich nicht mit den Einzelheiten des Betriebssystems und der zugrunde liegenden Geräte befassen müssen.
Verwenden Sie diesen Ausgabetyp, um Daten an einen FileStream, einen MemoryStream oder einen Ausgabedatenstream (Response.OutputStream) zu senden.
TextWriter
Der TextWriter schreibt sequenzielle Zeichen. Er ist in der StringWriter-Klasse und der StreamWriter-Klasse implementiert, die Zeichen in Zeichenfolgen bzw. in Datenströme schreiben. Verwenden Sie diesen Ausgabetyp, wenn die Ausgabe in eine Zeichenfolge erfolgen soll.
Hinweise
Beim Schreiben leerer Tags wird ein Leerzeichen zwischen das letzte Zeichen des Elementnamens und den umgekehrten Schrägstrich geschrieben, beispielsweise <myElement />. Dadurch können die generierten HTML-Seiten in älteren Webbrowsern ordnungsgemäß angezeigt werden.
