XmlTextWriter.WriteChars(Char[], Int32, Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
一次將文字寫入一個緩衝區。
public:
override void WriteChars(cli::array <char> ^ buffer, int index, int count);
public override void WriteChars (char[] buffer, int index, int count);
override this.WriteChars : char[] * int * int -> unit
Public Overrides Sub WriteChars (buffer As Char(), index As Integer, count As Integer)
參數
- buffer
- Char[]
包含要寫入之文字的字元陣列。
- index
- Int32
緩衝區中的位置指示要寫入的文字開頭。
- count
- Int32
要寫入的字元數。
例外狀況
buffer
為 null
。
index
或 count
小於零。
-或-
緩衝區長度減去 index
小於 count
;這個呼叫會導致 Surrogate 字組字元被分隔或寫入無效的 Surrogate 字組。
範例
using (XmlTextWriter writer = new XmlTextWriter(Console.Out))
{
writer.WriteStartDocument();
char[] ch = new char[4];
ch[0] = 't';
ch[1] = 'e';
ch[2] = 'x';
ch[3] = 't';
writer.WriteStartElement("WriteCharacters");
writer.WriteChars(ch, 0, ch.Length);
writer.WriteEndElement();
writer.WriteEndDocument();
}
備註
注意
從 .NET Framework 2.0 開始,建議您使用 XmlWriter.Create 方法和 XmlWriterSettings 類別來建立 XmlWriter 實例,以利用新功能。
這個方法可用來一次一個緩衝區寫入大量的文字。
必須進行特殊處理,以確保 WriteChars
方法不會跨多個緩衝區寫入分割 Surrogate 配對字元。 XML 規格會定義 Surrogate 配對的有效範圍。
如果寫入 Surrogate 配對字元會導致在緩衝區中分割 Surrogate 配對字元,就會擲回例外狀況。