XmlWriter.WriteElementStringAsync(String, String, String, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以非同步的方式寫入具有指定之前置詞、區域名稱、命名空間 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);
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
項目的值。
傳回
表示非同步 WriteElementString
作業的工作。
例外狀況
在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
-或-
在未將 Async 旗標設為 true
的情況下呼叫了 XmlWriter 非同步方法。 在此情況下,就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法,請將 XmlWriterSettings.Async 設為 true」。
備註
這是 的非同步版本 WriteElementString ,具有相同的功能。 若要使用這個方法,您必須將 Async 旗標設定為 true
。