XslCompiledTransform 類別上的輸出選項
更新: November 2007
本主題討論可用的 XSLT 輸出選項。您可以指定樣式表中或 Transform 方法上的輸出選項。
xsl:output 項目
xsl:output 項目指定輸出的選項。Transform 方法指定的輸出型別決定 xsl:output 選項的行為。
下表說明當輸出型別是一種資料流或 TextWriter 時,xsl:output 項目上可用之每個屬性的行為。
屬性名稱 |
行為 |
---|---|
method |
支援。 |
version |
忽略。對於 XML 版本始終為 1.0,對於 HTML 則為 4.0。 |
encoding |
輸出至 TextWriter 時忽略。使用 TextWriter.Encoding 屬性代替。 |
omit-xml-declaration |
支援。 |
standalone |
支援。 |
doctype-public |
支援。 |
doctype-system |
支援。 |
cdata-section-elements |
支援。 |
indent |
支援。 |
media-type |
支援。 |
傳送輸出至 XmlWriter
如果樣式表使用 xsl:output 項目,且輸出型別為 XmlWriter 物件,則在建立 XmlWriter 物件時應使用 XslCompiledTransform.OutputSettings 屬性。XslCompiledTransform.OutputSettings 屬性傳回 XmlWriterSettings 物件,該物件包含衍生自已編譯樣式表之 xsl:output 項目的資訊。可將此 XmlWriterSettings 物件傳遞給 XmlWriter.Create 方法,以正確的設定建立 XmlWriter 物件。
輸出型別
下列清單說明可用於 Transform 命令的輸出型別。
XmlWriter
XmlWriter 類別可寫出 XML 資料流或檔案。您可以藉由使用 XmlWriterSettings 類別,指定要在 XmlWriter 物件上支援的功能 (包含輸出選項)。XmlWriter 類別是 System.Xml 架構不可或缺的一部分。使用此輸出型別,將輸出結果傳遞至其他 XML 處理序。
String
使用此輸出型別,指定輸出檔案的 URI。
Stream
資料流是位元組序列的抽象,例如,檔案、輸入/輸出裝置、處理序間的通訊管道或 TCP/IP 通訊端。Stream 類別及其衍生類別提供不同類型輸入及輸出的一般檢視,可讓程式設計人員看不到作業系統及基礎裝置的特定詳細資訊。
使用此輸出型別傳送資料至 FileStream、MemoryStream 或輸出資料流 (Response.OutputStream)。
TextWriter
TextWriter 會寫入連續的字元。它會在 StringWriter 及 StreamWriter 類別中實作,這些類別會將字元分別寫入到字串或資料流。要輸出至字串時,請使用此輸出型別。
附註
- 寫出空白標記時,請在項目名稱的最後一個字元與反斜線之間寫入一個空格,例如 <myElement />。如此可讓舊版瀏覽器正確顯示所產生的 HTML 頁面。