語言

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

定義

命名空間:
System.Xml
組件:
System.Xml.dll, System.Xml.ReaderWriter.dll
組件:
netstandard.dll, System.Xml.ReaderWriter.dll
組件:
System.Xml.ReaderWriter.dll
組件:
System.Xml.dll
組件:
netstandard.dll
來源:
XmlWriterAsync.cs
來源:
XmlWriterAsync.cs
來源:
XmlWriterAsync.cs
來源:
XmlWriterAsync.cs
來源:
XmlWriterAsync.cs

非同步寫入 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

若非空，則會寫入 PUBLIC「pubid」「sysid」，其中 pubid 和 sysid 被替換為給定參數的值。

sysid
String

若 pubid 且 nullsysid 非空，則會寫入 SYSTEM 的「sysid」，其中 sysid 以該參數的值替換。

subset
String

若非空，則寫成 [subset]，其中 subset 被替換為該參數的值。

傳回

Task

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

例外狀況

InvalidOperationException

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

-或-

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

備註

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

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

適用於

另請參閱