XmlWriter.WriteNodeAsync 方法

  • 參考

定義

命名空間:
System.Xml
組件:
System.Xml.ReaderWriter.dll
組件:
System.Xml.dll
組件:
netstandard.dll

以非同步的方式將來源物件中的每個項目複製到目前的寫入器執行個體。

多載

WriteNodeAsync(XPathNavigator, Boolean)

以非同步方式將所有項目從 XPathNavigator 物件複製到寫入器。 XPathNavigator 的位置保持不變。
WriteNodeAsync(XmlReader, Boolean)

以非同步的方式從讀取器複製所有內容至寫入器，並將讀取器移至下一個同層級 (Sibling) 的開頭。

備註

這是 的非同步版本 WriteNode ，具有相同的功能。 若要使用此方法，您必須將 Async 旗標設定為 true 。

WriteNodeAsync(XPathNavigator, Boolean)

以非同步方式將所有項目從 XPathNavigator 物件複製到寫入器。 XPathNavigator 的位置保持不變。

public:
 virtual System::Threading::Tasks::Task ^ WriteNodeAsync(System::Xml::XPath::XPathNavigator ^ navigator, bool defattr);
public virtual System.Threading.Tasks.Task WriteNodeAsync (System.Xml.XPath.XPathNavigator navigator, bool defattr);
abstract member WriteNodeAsync : System.Xml.XPath.XPathNavigator * bool -> System.Threading.Tasks.Task
override this.WriteNodeAsync : System.Xml.XPath.XPathNavigator * bool -> System.Threading.Tasks.Task
Public Overridable Function WriteNodeAsync (navigator As XPathNavigator, defattr As Boolean) As Task

參數

navigator
XPathNavigator

要複製的來源 XPathNavigator。

defattr
Boolean

true 表示複製預設屬性，否則為 false。

傳回

Task

表示非同步 WriteNode 作業的工作。

例外狀況

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

-或-

在未將 Async 旗標設為 true的情況下呼叫了 XmlWriter 非同步方法。 在此情況下，就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法，請將 XmlWriterSettings.Async 設為 true」。

備註

這是 的非同步版本 WriteNode ，具有相同的功能。 若要使用此方法，您必須將 Async 旗標設定為 true 。

另請參閱

適用於

WriteNodeAsync(XmlReader, Boolean)

以非同步的方式從讀取器複製所有內容至寫入器，並將讀取器移至下一個同層級 (Sibling) 的開頭。

public:
 virtual System::Threading::Tasks::Task ^ WriteNodeAsync(System::Xml::XmlReader ^ reader, bool defattr);
public virtual System.Threading.Tasks.Task WriteNodeAsync (System.Xml.XmlReader reader, bool defattr);
abstract member WriteNodeAsync : System.Xml.XmlReader * bool -> System.Threading.Tasks.Task
override this.WriteNodeAsync : System.Xml.XmlReader * bool -> System.Threading.Tasks.Task
Public Overridable Function WriteNodeAsync (reader As XmlReader, defattr As Boolean) As Task

參數

reader
XmlReader

要從其中讀取的 XmlReader。

defattr
Boolean

若要從 true 複製預設屬性，則為 XmlReader，否則為 false。

傳回

Task

表示非同步 WriteNode 作業的工作。

例外狀況

InvalidOperationException

在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

-或-

在未將 Async 旗標設為 true的情況下呼叫了 XmlWriter 非同步方法。 在此情況下，就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法，請將 XmlWriterSettings.Async 設為 true」。

備註

這是 的非同步版本 WriteNode ，具有相同的功能。 若要使用此方法，您必須將 Async 旗標設定為 true 。

另請參閱

適用於