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 类及其派生类提供这些不同类型的输入和输出的通用视图,使程序员与操作系统和基础设备的具体细节相隔离。
使用此输出类型可以将数据发送到 FileStream、MemoryStream 或输出流 (Response.OutputStream
)。
TextWriter
TextWriter 输出序列字符。 此输出类型在 StringWriter 和 StreamWriter 类中实现,分别将字符输出到字符串或流。 如果希望输出到字符串,请使用此输出类型。
说明
在写出空标记时,会在元素名的最后一个字符与反斜杠之间写入一个空格,例如 <myElement />
。 这样,较旧的浏览器可以正确地显示生成的 HTML 页面。