Bagikan melalui


StreamReader.ReadLineAsync Metode

Definisi

Overload

ReadLineAsync()

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

ReadLineAsync(CancellationToken)

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

ReadLineAsync()

Sumber:
StreamReader.cs
Sumber:
StreamReader.cs
Sumber:
StreamReader.cs

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

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

Mengembalikan

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

Atribut

Pengecualian

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

Aliran telah dibuang.

Pembaca saat ini sedang digunakan oleh operasi baca sebelumnya.

Contoh

Contoh berikut menunjukkan cara membaca baris pertama file dengan menggunakan ReadLineAsync() metode .

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

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().

Berlaku untuk

ReadLineAsync(CancellationToken)

Sumber:
StreamReader.cs
Sumber:
StreamReader.cs
Sumber:
StreamReader.cs

Membaca baris karakter secara asinkron dari aliran 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

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

Pengecualian

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

Pembaca aliran telah dibuang.

Pembaca saat ini sedang digunakan oleh operasi baca sebelumnya.

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

Keterangan

Jika metode ini dibatalkan melalui cancellationToken, beberapa data yang telah dibaca dari saat ini Stream tetapi tidak disimpan (oleh StreamReader) atau dikembalikan (ke pemanggil) mungkin hilang.

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().

Berlaku untuk