XmlWriter.WriteNodeAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
以非同步的方式將來源物件中的每個項目複製到目前的寫入器執行個體。
多載
| 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.TaskPublic Overridable Function WriteNodeAsync (navigator As XPathNavigator, defattr As Boolean) As Task參數
- navigator
- XPathNavigator
要複製的來源 XPathNavigator。
- defattr
- Boolean
true 表示複製預設屬性，否則為 false。
傳回
表示非同步 WriteNode 作業的工作。
例外狀況
在先前的非同步作業完成前呼叫了 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.TaskPublic Overridable Function WriteNodeAsync (reader As XmlReader, defattr As Boolean) As Task參數
- defattr
- Boolean
若要從 true 複製預設屬性，則為 XmlReader，否則為 false。
傳回
表示非同步 WriteNode 作業的工作。
例外狀況
在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
-或-
在未將 Async 旗標設為 true的情況下呼叫了 XmlWriter 非同步方法。 在此情況下，就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法，請將 XmlWriterSettings.Async 設為 true」。
備註
這是 的非同步版本 WriteNode ，具有相同的功能。 若要使用此方法，您必須將 Async 旗標設定為 true 。