Freigeben über


Ausgabeoptionen für die XslCompiledTransform-Klasse

In diesem Artikel werden die verfügbaren XSLT-Ausgabeoptionen erläutert. Sie können Ausgabeoptionen im Stylesheet oder in der Transform Methode angeben.

xsl:output-Element

Das xsl:output Element gibt Optionen für die Ausgabe an. Der von der Transform Methode angegebene Ausgabetyp bestimmt das Verhalten der xsl:output Optionen.

In der folgenden Tabelle wird das Verhalten für jedes der Attribute beschrieben, die für das xsl:output Element verfügbar sind, wenn der Ausgabetyp ein Datenstrom oder ein TextWriterDatenstrom ist.

Attributname Verhalten
method Unterstützt.
Version Ignoriert. Die Version ist immer 1.0 für XML und 4.0 für HTML.
encoding Wird beim Ausgeben in ein TextWriter. Stattdessen wird die TextWriter.Encoding Eigenschaft verwendet.
Omit-xml-Deklaration Unterstützt.
Eigenständige Unterstützt.
doctype-public Unterstützt.
doctype-system Unterstützt.
cdata-section-elements Unterstützt.
Gedankenstrich Unterstützt.
Medientyp Unterstützt.

Senden der Ausgabe an einen XmlWriter

Wenn das Stylesheet das xsl:output Element verwendet und der Ausgabetyp ein XmlWriter Objekt ist, sollten Sie die XslCompiledTransform.OutputSettings Eigenschaft verwenden, wenn Sie das XmlWriter Objekt erstellen. Die XslCompiledTransform.OutputSettings Eigenschaft gibt ein XmlWriterSettings Objekt zurück, das Informationen enthält, die xsl:output vom Element eines kompilierten Stylesheets abgeleitet wurden. Dieses XmlWriterSettings Objekt kann an die XmlWriter.Create Methode übergeben werden, um ein XmlWriter Objekt mit den richtigen Einstellungen zu erstellen.

Ausgabetypen

In der folgenden Liste werden die Ausgabetypen beschrieben, die für den Transform Befehl verfügbar sind.

Xmlwriter

Die XmlWriter Klasse schreibt XML-Datenströme oder -Dateien aus. Mithilfe der Klasse können Sie die Features angeben, die für das XmlWriter Objekt unterstützt werden sollen, XmlWriterSettings einschließlich Ausgabeoptionen. Die XmlWriter Klasse ist ein integraler Bestandteil des System.Xml Rahmens. Verwenden Sie diesen Ausgabetyp, um die Ausgabeergebnisse in einen anderen XML-Prozess zu pipelineieren.

String

Verwenden Sie diesen Ausgabetyp, um den URI der Ausgabedatei anzugeben.

Streamen

Ein Datenstrom ist eine Abstraktion einer Bytesequenz, z. B. einer Datei, eines Eingabe-/Ausgabegeräts, einer prozessübergreifenden Kommunikationspipeline oder eines TCP/IP-Sockets. Die Stream Klasse und die abgeleiteten Klassen bieten eine generische Ansicht dieser verschiedenen Eingabe- und Ausgabetypen und isolieren den Programmierer aus den spezifischen Details des Betriebssystems und der zugrunde liegenden Geräte.

Verwenden Sie diesen Ausgabetyp, um Daten an einen FileStream, MemoryStreamoder einen Ausgabedatenstrom (Response.OutputStream) zu senden.

TextWriter

Die TextWriter schreibgeschützten Zeichen. Sie wird in den StringWriter Klassen implementiert StreamWriter , die Zeichen in Zeichenfolgen oder Datenströme schreiben. Verwenden Sie diesen Ausgabetyp, wenn Sie eine Zeichenfolge ausgeben möchten.

Hinweise

Beim Schreiben leerer Tags wird ein Leerzeichen zwischen dem letzten Zeichen des Elementnamens und dem umgekehrten Schrägstrich geschrieben. <myElement /> Auf diese Weise können ältere Browser die generierten HTML-Seiten richtig anzeigen.

Siehe auch