XmlReader.ReadContentAsStringAsync 方法

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReaderAsync.cs

以对象的形式 String 异步读取当前位置的文本内容。

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

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

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

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

返回

Task<String>

作为对象的文本内容 String 。

例外

InvalidOperationException

在上一个异步操作完成之前调用了一个 XmlReader 方法。 在这种情况下， InvalidOperationException 会引发消息“正在进行异步操作”。

-或-

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

注解

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

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

另请参阅

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