XmlReader.ReadOuterXmlAsync 方法

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

异步读取内容，包括标记，表示此节点及其所有子级。

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadOuterXmlAsync();

public virtual System.Threading.Tasks.Task<string> ReadOuterXmlAsync();

abstract member ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadOuterXmlAsync : unit -> System.Threading.Tasks.Task<string>

Public Overridable Function ReadOuterXmlAsync () As Task(Of String)

返回

Task<String>

如果读取器位于元素或属性节点上，此方法将返回当前节点及其所有子节点的所有 XML 内容，包括标记;否则，它将返回一个空字符串。

例外

InvalidOperationException

未将标志设置为 /> 即可调用异步方法。 在这种情况下，如果想要使用 Async 方法， InvalidOperationException 则会引发消息“将 XmlReaderSettings.Async 设置为 true”。

注解

这是具有相同功能的异步版本 ReadOuterXml。 若要使用此方法，必须将标志设置为 Asynctrue。

此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 ReadOuterXml()..

另请参阅

• 异步编程 （C#）
• 使用 Async 和 Await 进行异步编程（Visual Basic）