XmlTextWriter 類別

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlTextWriter.cs

表示提供快速、非快取、順向方式產生數據流或檔案的寫入器，其中包含符合 W3C 可延伸標記語言 （XML） 1.0 和 XML 建議中的命名空間的 XML 數據。

從 .NET Framework 2.0 開始，我們建議您改用 XmlWriter 類別。

public ref class XmlTextWriter : System::Xml::XmlWriter

public class XmlTextWriter : System.Xml.XmlWriter

type XmlTextWriter = class
    inherit XmlWriter

Public Class XmlTextWriter
Inherits XmlWriter

繼承

Object

XmlWriter

XmlTextWriter

備註

如需此 API 的詳細資訊，請參閱 xmlTextWriter補充 API 備註。

建構函式

XmlTextWriter(Stream, Encoding)	使用指定的數據流和編碼，建立 XmlTextWriter 類別的實例。
XmlTextWriter(String, Encoding)	使用指定的檔案建立 XmlTextWriter 類別的實例。
XmlTextWriter(TextWriter)	使用指定的 TextWriter，建立 XmlTextWriter 類別的實例。

屬性

BaseStream	取得基礎數據流物件。
Formatting	指出輸出的格式。
Indentation	取得或設定當 Formatting 設定為 Formatting.Indented時，階層中每個層級要寫入多少 IndentChars。
IndentChar	取得或設定當 Formatting 設定為 Formatting.Indented時，要用於縮排的字元。
Namespaces	取得或設定值，指出是否要支援命名空間。
QuoteChar	取得或設定要用來引號屬性值的字元。
Settings	取得用來建立這個 XmlWriter 實例的 XmlWriterSettings 物件。 (繼承來源 XmlWriter)
WriteState	取得寫入器的狀態。
XmlLang	取得目前 xml:lang 範圍。
XmlSpace	取得代表目前 xml:space 範圍的 XmlSpace。

方法

Close()	關閉此數據流和基礎數據流。
Dispose()	釋放目前 XmlWriter 類別實例所使用的所有資源。 (繼承來源 XmlWriter)
Dispose(Boolean)	釋放 XmlWriter 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 XmlWriter)
DisposeAsync()	以異步方式執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。 (繼承來源 XmlWriter)
DisposeAsyncCore()	以異步方式執行與釋放、釋放或重設受控資源相關聯的應用程式定義工作。 (繼承來源 XmlWriter)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Flush()	將緩衝區中的任何內容排清到基礎數據流，並排清基礎數據流。
FlushAsync()	以異步方式將緩衝區中任何內容排清到基礎數據流，也會排清基礎數據流。 (繼承來源 XmlWriter)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
LookupPrefix(String)	傳回命名空間 URI 目前命名空間範圍中定義的最接近前置詞。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
WriteAttributes(XmlReader, Boolean)	在衍生類別中覆寫時，寫出在 XmlReader中目前位置找到的所有屬性。 (繼承來源 XmlWriter)
WriteAttributesAsync(XmlReader, Boolean)	以異步方式寫出在 XmlReader中目前位置找到的所有屬性。 (繼承來源 XmlWriter)
WriteAttributeString(String, String)	在衍生類別中覆寫時，以指定的本機名稱和值寫出 屬性。 (繼承來源 XmlWriter)
WriteAttributeString(String, String, String)	在衍生類別中覆寫時，寫入具有指定區域名稱、命名空間 URI 和值的屬性。 (繼承來源 XmlWriter)
WriteAttributeString(String, String, String, String)	在衍生類別中覆寫時，寫出具有指定前置詞、本機名稱、命名空間 URI 和值的屬性。 (繼承來源 XmlWriter)
WriteAttributeStringAsync(String, String, String, String)	以異步方式寫出具有指定前置詞、本機名稱、命名空間 URI 和值的屬性。 (繼承來源 XmlWriter)
WriteBase64(Byte[], Int32, Int32)	將指定的二進位位元組編碼為base64，並寫出產生的文字。
WriteBase64Async(Byte[], Int32, Int32)	以異步方式將指定的二進位位元組編碼為Base64，並寫出產生的文字。 (繼承來源 XmlWriter)
WriteBinHex(Byte[], Int32, Int32)	將指定的二進位位元組編碼為 binhex，並寫出產生的文字。
WriteBinHexAsync(Byte[], Int32, Int32)	以異步方式將指定的二進位位元組編碼為 BinHex，並寫出產生的文字。 (繼承來源 XmlWriter)
WriteCData(String)	寫出 <！[CDATA[...]]包含指定文字的> 區塊。
WriteCDataAsync(String)	以異步方式寫出 <！[CDATA[...]]包含指定文字的> 區塊。 (繼承來源 XmlWriter)
WriteCharEntity(Char)	強制產生指定 Unicode 字元值的字元實體。
WriteCharEntityAsync(Char)	以異步方式強制產生指定 Unicode 字元值的字元實體。 (繼承來源 XmlWriter)
WriteChars(Char[], Int32, Int32)	一次寫入一個緩衝區的文字。
WriteCharsAsync(Char[], Int32, Int32)	以異步方式一次寫入一個緩衝區的文字。 (繼承來源 XmlWriter)
WriteComment(String)	寫出包含指定文字的批註 <!--...-->。
WriteCommentAsync(String)	以異步方式寫出包含指定文字的批註 <!--...-->。 (繼承來源 XmlWriter)
WriteDocType(String, String, String, String)	使用指定的名稱和選擇性屬性寫入 DOCTYPE 宣告。
WriteDocTypeAsync(String, String, String, String)	以異步方式寫入具有指定名稱和選擇性屬性的 DOCTYPE 宣告。 (繼承來源 XmlWriter)
WriteElementString(String, String)	寫入具有指定區域名稱和值的專案。 (繼承來源 XmlWriter)
WriteElementString(String, String, String)	寫入具有指定區域名稱、命名空間 URI 和值的專案。 (繼承來源 XmlWriter)
WriteElementString(String, String, String, String)	寫入具有指定前置詞、區域名稱、命名空間 URI 和值的專案。 (繼承來源 XmlWriter)
WriteElementStringAsync(String, String, String, String)	以異步方式寫入具有指定前置詞、本機名稱、命名空間 URI 和值的專案。 (繼承來源 XmlWriter)
WriteEndAttribute()	關閉前一個 WriteStartAttribute(String, String, String) 呼叫。
WriteEndAttributeAsync()	以異步方式關閉先前 WriteStartAttribute(String, String) 呼叫。 (繼承來源 XmlWriter)
WriteEndDocument()	關閉任何開啟的項目或屬性，並將寫入器放回 Start 狀態。
WriteEndDocumentAsync()	以異步方式關閉任何開啟的項目或屬性，並將寫入器放回 Start 狀態。 (繼承來源 XmlWriter)
WriteEndElement()	關閉一個項目並彈出對應的命名空間範圍。
WriteEndElementAsync()	以異步方式關閉一個元素，並彈出對應的命名空間範圍。 (繼承來源 XmlWriter)
WriteEntityRef(String)	將實體參考寫出為 &name;。
WriteEntityRefAsync(String)	以異步方式將實體參考寫出為 &name;。 (繼承來源 XmlWriter)
WriteFullEndElement()	關閉一個項目並彈出對應的命名空間範圍。
WriteFullEndElementAsync()	以異步方式關閉一個元素，並彈出對應的命名空間範圍。 (繼承來源 XmlWriter)
WriteName(String)	寫出指定的名稱，確保它是有效的名稱，根據 W3C XML 1.0 建議。
WriteNameAsync(String)	以異步方式寫出指定的名稱，確保它是根據 W3C XML 1.0 建議的有效名稱（https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name）。 (繼承來源 XmlWriter)
WriteNmToken(String)	根據 W3C XML 1.0 建議，寫出指定的名稱，確保它是有效的 NmToken。
WriteNmTokenAsync(String)	根據 W3C XML 1.0 建議，以異步方式寫出指定的名稱，確保它是有效的 NmToken （https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name）。 (繼承來源 XmlWriter)
WriteNode(XmlReader, Boolean)	在衍生類別中覆寫時，將讀取器的所有內容複製到寫入器，並將讀取器移至下一個同層級的開頭。 (繼承來源 XmlWriter)
WriteNode(XPathNavigator, Boolean)	將 XPathNavigator 物件的所有專案複製到寫入器。 XPathNavigator 的位置保持不變。 (繼承來源 XmlWriter)
WriteNodeAsync(XmlReader, Boolean)	以異步方式將讀取器的所有專案複製到寫入器，並將讀取器移至下一個同層級的開頭。 (繼承來源 XmlWriter)
WriteNodeAsync(XPathNavigator, Boolean)	以異步方式將所有專案從 XPathNavigator 物件複製到寫入器。 XPathNavigator 的位置保持不變。 (繼承來源 XmlWriter)
WriteProcessingInstruction(String, String)	寫出名稱與文字之間有空格的處理指令，如下所示：<？name text？>。
WriteProcessingInstructionAsync(String, String)	以異步方式寫出處理指令，其名稱與文字之間有空格，如下所示：<？name text？>。 (繼承來源 XmlWriter)
WriteQualifiedName(String, String)	寫出命名空間限定名稱。 這個方法會查閱指定命名空間範圍中的前置詞。
WriteQualifiedNameAsync(String, String)	以異步方式寫出命名空間限定名稱。 這個方法會查閱指定命名空間範圍中的前置詞。 (繼承來源 XmlWriter)
WriteRaw(Char[], Int32, Int32)	從字元緩衝區手動寫入原始標記。
WriteRaw(String)	從字串手動寫入原始標記。
WriteRawAsync(Char[], Int32, Int32)	以異步方式從字元緩衝區手動寫入原始標記。 (繼承來源 XmlWriter)
WriteRawAsync(String)	以異步方式從字串手動寫入原始標記。 (繼承來源 XmlWriter)
WriteStartAttribute(String)	寫入具有指定區域名稱的屬性開頭。 (繼承來源 XmlWriter)
WriteStartAttribute(String, String)	寫入具有指定本機名稱和命名空間 URI 的屬性開頭。 (繼承來源 XmlWriter)
WriteStartAttribute(String, String, String)	寫入屬性的開頭。
WriteStartAttributeAsync(String, String, String)	以異步方式寫入具有指定前置詞、本機名稱和命名空間 URI 的屬性開頭。 (繼承來源 XmlWriter)
WriteStartDocument()	使用版本 「1.0」 寫入 XML 宣告。
WriteStartDocument(Boolean)	使用版本 「1.0」 和獨立屬性寫入 XML 宣告。
WriteStartDocumentAsync()	以異步方式寫入 XML 宣告與版本 「1.0」。。 (繼承來源 XmlWriter)
WriteStartDocumentAsync(Boolean)	使用版本 「1.0」 和獨立屬性，以異步方式寫入 XML 宣告。 (繼承來源 XmlWriter)
WriteStartElement(String)	在衍生類別中覆寫時，寫出具有指定區域名稱的起始標記。 (繼承來源 XmlWriter)
WriteStartElement(String, String)	在衍生類別中覆寫時，寫入指定的開始標記，並將它與指定的命名空間產生關聯。 (繼承來源 XmlWriter)
WriteStartElement(String, String, String)	寫入指定的開始標記，並將它與指定的命名空間和前置詞產生關聯。
WriteStartElementAsync(String, String, String)	以異步方式寫入指定的開始標記，並將它與指定的命名空間和前置詞產生關聯。 (繼承來源 XmlWriter)
WriteString(String)	寫入指定的文字內容。
WriteStringAsync(String)	以異步方式寫入指定的文字內容。 (繼承來源 XmlWriter)
WriteSurrogateCharEntity(Char, Char)	產生並寫入 Surrogate 字元組的 Surrogate 字元實體。
WriteSurrogateCharEntityAsync(Char, Char)	以異步方式產生並寫入 Surrogate 字元組的 Surrogate 字元實體。 (繼承來源 XmlWriter)
WriteValue(Boolean)	寫入 Boolean 值。 (繼承來源 XmlWriter)
WriteValue(DateTime)	寫入 DateTime 值。 (繼承來源 XmlWriter)
WriteValue(DateTimeOffset)	寫入 DateTimeOffset 值。 (繼承來源 XmlWriter)
WriteValue(Decimal)	寫入 Decimal 值。 (繼承來源 XmlWriter)
WriteValue(Double)	寫入 Double 值。 (繼承來源 XmlWriter)
WriteValue(Int32)	寫入 Int32 值。 (繼承來源 XmlWriter)
WriteValue(Int64)	寫入 Int64 值。 (繼承來源 XmlWriter)
WriteValue(Object)	寫入物件值。 (繼承來源 XmlWriter)
WriteValue(Single)	寫入單精度浮點數。 (繼承來源 XmlWriter)
WriteValue(String)	寫入 String 值。 (繼承來源 XmlWriter)
WriteWhitespace(String)	寫出指定的空格符。
WriteWhitespaceAsync(String)	以異步方式寫出指定的空格符。 (繼承來源 XmlWriter)

擴充方法

ConfigureAwait(IAsyncDisposable, Boolean)

設定如何執行從異步可處置專案傳回的工作等候。

另請參閱

• XML 檔和數據