XslCompiledTransform 类的输出选项

本文讨论可用的 XSLT 输出选项。 可以在样式表中指定输出选项,或在 Transform 方法上指定输出选项。

xsl:output 元素

xsl:output 元素指定输出选项。 Transform 方法指定的输出类型确定 xsl:output 选项的行为。

下表说明当输出类型为流或 xsl:output 时,TextWriter 元素的每个可用属性的行为。

特性名 行为
method 支持。
version 已忽略。 对于 XML,版本始终是 1.0,对于 HTML,版本始终是 4.0。
encoding 在输出到 TextWriter 时忽略。 使用 TextWriter.Encoding 属性取代。
omit-xml-declaration 支持。
独立 支持。
doctype-public 支持。
doctype-system 支持。
cdata-section-elements 支持。
indent 支持。
media-type 支持。

将输出发送到 XmlWriter

如果样式表使用 xsl:output 元素并且输出类型为 XmlWriter 对象,在创建 XslCompiledTransform.OutputSettings 对象时应使用 XmlWriter 属性。 XslCompiledTransform.OutputSettings 属性返回包含从已编译样式表的 XmlWriterSettings 元素派生的信息的 xsl:output 对象。 此 XmlWriterSettings 对象可以传递给 XmlWriter.Create 方法,以使用正确的设置创建 XmlWriter 对象。

输出类型

下表说明 Transform 命令的可用输出类型。

XmlWriter

XmlWriter 类输出 XML 流或文件。 可以使用 XmlWriter 类指定 XmlWriterSettings 对象上要支持的功能,包括输出选项。 XmlWriter 类是 System.Xml 框架必不可少的一个部分。 使用此输出类型可以将输出结果通过管道发送给另一个 XML 进程。

String

使用此输出类型可以指定输出文件的 URI。

流是字节序列的抽象,例如文件、输入/输出设备、进程中通信管道或 TCP/IP 套接字。 Stream 类及其派生类提供这些不同类型的输入和输出的通用视图,使程序员与操作系统和基础设备的具体细节相隔离。

使用此输出类型可以将数据发送到 FileStreamMemoryStream 或输出流 (Response.OutputStream)。

TextWriter

TextWriter 输出序列字符。 此输出类型在 StringWriterStreamWriter 类中实现,分别将字符输出到字符串或流。 如果希望输出到字符串,请使用此输出类型。

说明

在写出空标记时,会在元素名的最后一个字符与反斜杠之间写入一个空格,例如 <myElement />。 这样,较旧的浏览器可以正确地显示生成的 HTML 页面。

请参阅