StringReader.ReadLineAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Overload

ReadLineAsync()	Membaca baris karakter secara asinkron dari string saat ini dan mengembalikan data sebagai string.
ReadLineAsync(CancellationToken)	Membaca baris karakter secara asinkron dari string saat ini dan mengembalikan data sebagai string.

ReadLineAsync()

Sumber:

StringReader.cs

Membaca baris karakter secara asinkron dari string saat ini dan mengembalikan data sebagai string.

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

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)

Mengembalikan

Task<String>

Tugas yang mewakili operasi baca asinkron. Nilai TResult parameter berisi baris berikutnya dari pembaca string, atau jika null semua karakter telah dibaca.

Pengecualian

ArgumentOutOfRangeException

Jumlah karakter di baris berikutnya lebih besar dari Int32.MaxValue.

ObjectDisposedException

Pembaca string telah dibuang.

InvalidOperationException

Pembaca saat ini sedang digunakan oleh operasi baca sebelumnya.

Contoh

Contoh berikut menunjukkan cara membaca satu baris pada satu waktu dari string secara asinkron.

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");

            string readText;

            using (StringReader reader = new StringReader(stringToRead.ToString()))
            {
                while ((readText = await reader.ReadLineAsync()) != null)
                {
                    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.ReadLineAsync()
            While Not IsNothing(readText)
                Console.WriteLine(readText)
                readText = Await reader.ReadLineAsync()
            End While
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in 1st line to read
' and 2nd line
' and the end
'

Keterangan

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh ReadLine().

ReadLineAsync(CancellationToken)

Sumber:

StringReader.cs

Membaca baris karakter secara asinkron dari string saat ini dan mengembalikan data sebagai string.

public:
 override System::Threading::Tasks::ValueTask<System::String ^> ReadLineAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.ValueTask<string?> ReadLineAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>

Public Overrides Function ReadLineAsync (cancellationToken As CancellationToken) As ValueTask(Of String)

Parameter

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

ValueTask<String>

Tugas nilai yang mewakili operasi baca asinkron. Nilai TResult parameter berisi baris berikutnya dari pembaca string, atau jika null semua karakter telah dibaca.

Pengecualian

ArgumentOutOfRangeException

Jumlah karakter di baris berikutnya lebih besar dari Int32.MaxValue.

ObjectDisposedException

Pembaca string telah dibuang.

InvalidOperationException

Pembaca saat ini sedang digunakan oleh operasi baca sebelumnya.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh ReadLine().