XmlWriter.WriteElementStringAsync(String, String, String, String) 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlWriter.cs

非同步寫入一個元素，包含指定的前綴、本地名稱、命名空間 URI 和值。

public:
 System::Threading::Tasks::Task ^ WriteElementStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

public System.Threading.Tasks.Task WriteElementStringAsync(string? prefix, string localName, string? ns, string value);

member this.WriteElementStringAsync : string * string * string * string -> System.Threading.Tasks.Task

Public Function WriteElementStringAsync (prefix As String, localName As String, ns As String, value As String) As Task

參數

prefix

String

元素的前綴。

localName

String

該元素的地方名稱。

ns

String

元素的命名空間 URI。

value

String

元素的值。

傳回

Task

代表非同步 WriteElementString 操作的任務。

例外狀況

InvalidOperationException

在先前非同步操作結束前，會呼叫一個 XmlWriter 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。

-或-

呼叫非 XmlWriter 同步方法時未將 Async 標記設為 true。 此時， InvalidOperationException 會丟出訊息「若你想使用非同步方法，將 XmlWriterSettings.Async 設為 true。」

備註

這是 的 WriteElementString非同步版本，功能相同。 使用此方法時，必須將 標記設 Async 為 true。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 WriteElementString(String, String, String, String)拋出的例外。

另請參閱

• 非同步程式設計（C#）
• 非同步與等待的非同步程式設計（Visual Basic 語言）