StringReader.ReadToEndAsync 方法

参考

定义

命名空间:: System.IO

程序集:: System.IO.dll

程序集:: System.Runtime.dll

程序集:: System.Runtime.Extensions.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

ReadToEndAsync()	异步读取从当前位置到字符串的结尾的所有字符并将它们作为单个字符串返回。
ReadToEndAsync(CancellationToken)	异步读取从当前位置到字符串的结尾的所有字符并将它们作为单个字符串返回。

ReadToEndAsync()

Source:: StringReader.cs

Source:: StringReader.cs

Source:: StringReader.cs

异步读取从当前位置到字符串的结尾的所有字符并将它们作为单个字符串返回。

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync();

public override System.Threading.Tasks.Task<string> ReadToEndAsync ();

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<string> ReadToEndAsync ();

override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>

Public Overrides Function ReadToEndAsync () As Task(Of String)

Task<String>

表示异步读取操作的任务。 TResult 参数值包括字符串来自当前位置到结束字符串字符。

属性: ComVisibleAttribute

例外

ArgumentOutOfRangeException

字符数大于 Int32.MaxValue。

ObjectDisposedException

字符串读取器已被释放。

InvalidOperationException

以前的读取操作当前正在使用读取器。

示例

以下示例演示如何异步读取整个字符串。

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            ReadCharacters();
        }

        static async void ReadCharacters()
        {
            StringBuilder stringToRead = new StringBuilder();
            stringToRead.AppendLine("Characters in 1st line to read");
            stringToRead.AppendLine("and 2nd line");
            stringToRead.AppendLine("and the end");

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                string readText = await reader.ReadToEndAsync();
                Console.WriteLine(readText);
            }
        }
    }
}
// The example displays the following output:
//
// Characters in 1st line to read
// and 2nd line
// and the end
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim stringToRead = New StringBuilder()
        stringToRead.AppendLine("Characters in 1st line to read")
        stringToRead.AppendLine("and 2nd line")
        stringToRead.AppendLine("and the end")

        Using reader As StringReader = New StringReader(stringToRead.ToString())
            Dim readText As String = Await reader.ReadToEndAsync()
            Console.WriteLine(readText)
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

注解

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

适用于

ReadToEndAsync(CancellationToken)

Source:: StringReader.cs

Source:: StringReader.cs

Source:: StringReader.cs