XmlWriter.WriteCharsAsync(Char[], Int32, Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以非同步的方式一次將文字寫入一個緩衝區。
public:
virtual System::Threading::Tasks::Task ^ WriteCharsAsync(cli::array <char> ^ buffer, int index, int count);
public virtual System.Threading.Tasks.Task WriteCharsAsync (char[] buffer, int index, int count);
abstract member WriteCharsAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteCharsAsync : char[] * int * int -> System.Threading.Tasks.Task
Public Overridable Function WriteCharsAsync (buffer As Char(), index As Integer, count As Integer) As Task
參數
- buffer
- Char[]
包含要寫入之文字的字元陣列。
- index
- Int32
緩衝區中的位置指示要寫入的文字開頭。
- count
- Int32
要寫入的字元數。
傳回
表示非同步 WriteChars
作業的工作。
例外狀況
在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
-或-
在未將 Async 旗標設為 true
的情況下呼叫了 XmlWriter 非同步方法。 在此情況下,就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法,請將 XmlWriterSettings.Async 設為 true」。
備註
這是 的非同步版本 WriteChars ,具有相同的功能。 若要使用此方法,您必須將 Async 旗標設定為 true
。