XmlTextWriter 類別

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

Source:

XmlTextWriter.cs

表示提供產生資料流或檔案的快速、非快取、順向方法的寫入器，這些資料流或檔案中包含符合 W3C Extensible Markup Language (XML) 1.0 與 XML Recommendation 中命名空間的 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 時，每一層級要寫入多少縮排字元。
IndentChar	取得或設定當 Formatting 設為 Formatting.Indented 時用於縮排的字元。
Namespaces	取得或設定值，指出是否支援命名空間。
QuoteChar	取得或設定用來括住屬性值的字元。
Settings	取得 XmlWriterSettings 物件，用於建立這個 XmlWriter 執行個體。 (繼承來源 XmlWriter)
WriteState	取得寫入器的狀態。
XmlLang	取得目前的 xml:lang 範圍。
XmlSpace	取得 XmlSpace，表示目前的 xml:space 範圍。

方法

Close()	關閉這個資料流與基礎資料流。
Dispose()	釋放 XmlWriter 類別目前的執行個體所使用的全部資源。 (繼承來源 XmlWriter)
Dispose(Boolean)	釋放 XmlWriter 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 XmlWriter)
DisposeAsync()	非同步執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之由應用程式定義的工作。 (繼承來源 XmlWriter)
DisposeAsyncCore()	以非同步方式執行與釋放 (Free)、釋放 (Release) 或重設受控資源相關聯的應用程式定義工作。 (繼承來源 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()	關閉任何開啟的項目或屬性，並將寫入器回復開始狀態。
WriteEndDocumentAsync()	以非同步的方式關閉任何開啟的項目或屬性，並將寫入器回復開始狀態。 (繼承來源 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)	在衍生類別中覆寫時，從讀取器複製所有內容至寫入器，並將讀取器移至下一個同層級 (Sibling) 的開頭。 (繼承來源 XmlWriter)
WriteNode(XPathNavigator, Boolean)	將 XPathNavigator 物件中的所有項目複製到寫入器。 XPathNavigator 的位置保持不變。 (繼承來源 XmlWriter)
WriteNodeAsync(XmlReader, Boolean)	以非同步的方式從讀取器複製所有內容至寫入器，並將讀取器移至下一個同層級 (Sibling) 的開頭。 (繼承來源 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)	從字串手動寫入未經處理的標記 (Raw Markup)。
WriteRawAsync(Char[], Int32, Int32)	以非同步的方式從字元緩衝區手動寫入未經處理的標記。 (繼承來源 XmlWriter)
WriteRawAsync(String)	以非同步的方式從字串手動寫入未經處理的標記 (Raw Markup)。 (繼承來源 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()	以非同步的方式使用「1.0」版寫入 XML 宣告。 (繼承來源 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)

設定如何執行從非同步可處置項目傳回的工作 await。

另請參閱

• XML 文件和資料