XmlWriter.WriteDocTypeAsync(String, String, String, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以非同步的方式寫入具有指定名稱與選擇性屬性的 DOCTYPE 宣告。
public:
virtual System::Threading::Tasks::Task ^ WriteDocTypeAsync(System::String ^ name, System::String ^ pubid, System::String ^ sysid, System::String ^ subset);
public virtual System.Threading.Tasks.Task WriteDocTypeAsync (string name, string pubid, string sysid, string subset);
public virtual System.Threading.Tasks.Task WriteDocTypeAsync (string name, string? pubid, string? sysid, string? subset);
abstract member WriteDocTypeAsync : string * string * string * string -> System.Threading.Tasks.Task
override this.WriteDocTypeAsync : string * string * string * string -> System.Threading.Tasks.Task
Public Overridable Function WriteDocTypeAsync (name As String, pubid As String, sysid As String, subset As String) As Task
參數
- name
- String
DOCTYPE 名稱。 這必須不是空白的。
- pubid
- String
如果為非 null,它也會寫入 PUBLIC "pubid" "sysid",其中 pubid
與 sysid
會替換為指定之引數的值。
- sysid
- String
如果 pubid
是 null
,而 sysid
為非 null,則它會寫入 SYSTEM "sysid",其中 sysid
會由這個引數的值所取代。
- subset
- String
如果非 Null,它會寫入 [subset],其中 subset 由這個引數的值來替代。
傳回
表示非同步 WriteDocType
作業的工作。
例外狀況
在先前的非同步作業完成前呼叫了 XmlWriter 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
-或-
在未將 Async 旗標設為 true
的情況下呼叫了 XmlWriter 非同步方法。 在此情況下,就會擲回 InvalidOperationException 並顯示訊息「如果您要使用非同步方法,請將 XmlWriterSettings.Async 設為 true」。
備註
這是 的非同步版本 WriteDocType ,具有相同的功能。 若要使用這個方法,您必須將 Async 旗標設定為 true
。