StreamReader.ReadLineAsync StreamReader.ReadLineAsync StreamReader.ReadLineAsync StreamReader.ReadLineAsync Method

定義

現在のストリームから非同期的に 1 行分の文字を読み取り、そのデータを文字列として返します。Reads a line of characters asynchronously from the current stream and returns the data as a string.

public:
 override System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task<string> ReadLineAsync ();
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
Public Overrides Function ReadLineAsync () As Task(Of String)

戻り値

非同期の読み取り操作を表すタスク。A task that represents the asynchronous read operation. TResult パラメーターの値には、ストリームの次の行が含まれます。または、すべての文字が読み取られた場合は null です。The value of the TResult parameter contains the next line from the stream, or is null if all the characters have been read.

例外

次の行の文字数が、MaxValue を超えています。The number of characters in the next line is larger than MaxValue.

ストリームは破棄されています。The stream has been disposed.

リーダーは、前の読み取り操作によって現在使用されています。The reader is currently in use by a previous read operation.

次の例は、 ReadLineAsync()メソッドを使用してファイルの最初の行を読み取る方法を示しています。The following example shows how to read the first line of a file by using the ReadLineAsync() method.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static async Task Main()
        {
            await ReadCharacters();
        }

        static async Task ReadCharacters()
        {
            String result;
            using (StreamReader reader = File.OpenText("existingfile.txt"))
            {
                Console.WriteLine("Opened file.");
                result = await reader.ReadLineAsync();
                Console.WriteLine("First line contains: " + result);
            }
        }
    }
}
Imports System.IO

Module Module1

    Sub Main()
        ReadCharacters()
    End Sub

    Async Sub ReadCharacters()
        Dim result As String

        Using reader As StreamReader = File.OpenText("existingfile.txt")
            Console.WriteLine("Opened file.")
            result = Await reader.ReadLineAsync()
            Console.WriteLine("First line contains: " + result)
        End Using
    End Sub
End Module

適用対象