StreamWriter.WriteLineAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Secara asinkron menulis data ke aliran, diikuti oleh terminator baris.

Overload

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Secara asinkron menulis representasi teks dari wilayah memori karakter ke aliran, diikuti oleh terminator baris.
WriteLineAsync()	Secara asinkron menulis terminator baris ke aliran.
WriteLineAsync(Char)	Secara asinkron menulis karakter ke aliran, diikuti oleh terminator garis.
WriteLineAsync(String)	Secara asinkron menulis string ke aliran, diikuti oleh terminator garis.
WriteLineAsync(Char[], Int32, Int32)	Secara asinkron menulis subarray karakter ke aliran, diikuti oleh terminator garis.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Sumber:

StreamWriter.cs

Secara asinkron menulis representasi teks dari wilayah memori karakter ke aliran, diikuti oleh terminator baris.

public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

buffer

ReadOnlyMemory<Char>

Wilayah memori karakter untuk menulis ke aliran.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

OperationCanceledException

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

Keterangan

Terminator garis ditentukan oleh CoreNewLine bidang .

WriteLineAsync()

Sumber:

StreamWriter.cs

Secara asinkron menulis terminator baris ke aliran.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync();

public override System.Threading.Tasks.Task WriteLineAsync ();

override this.WriteLineAsync : unit -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync () As Task

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ObjectDisposedException

Penulis aliran dibuang.

InvalidOperationException

Penulis aliran saat ini sedang digunakan oleh operasi tulis sebelumnya.

Keterangan

Terminator baris ditentukan oleh TextWriter.NewLine properti .

WriteLineAsync(Char)

Sumber:

StreamWriter.cs

Secara asinkron menulis karakter ke aliran, diikuti oleh terminator garis.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(char value);

public override System.Threading.Tasks.Task WriteLineAsync (char value);

override this.WriteLineAsync : char -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As Char) As Task

Parameter

value

Char

Karakter untuk menulis ke aliran.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ObjectDisposedException

Penulis aliran dibuang.

InvalidOperationException

Penulis aliran saat ini sedang digunakan oleh operasi tulis sebelumnya.

Contoh

Contoh berikut menunjukkan cara menulis satu karakter (huruf "a") ke baris dalam file teks, diikuti oleh baris lain yang berisi satu karakter (huruf "b"), dengan menggunakan WriteLineAsync(Char) metode .

using System.IO;

namespace ConsoleApplication
{
    class Program3
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync('a');
                await writer.WriteLineAsync('b');
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim firstChar As Char = "a"
        Dim secondChar As Char = "b"
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(firstChar)
            Await writer.WriteLineAsync(secondChar)
        End Using
    End Sub
End Module

Keterangan

Terminator baris ditentukan oleh TextWriter.NewLine properti .

WriteLineAsync(String)

Sumber:

StreamWriter.cs

Secara asinkron menulis string ke aliran, diikuti oleh terminator garis.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);

public override System.Threading.Tasks.Task WriteLineAsync (string? value);

override this.WriteLineAsync : string -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As String) As Task

Parameter

value

String

String yang akan ditulis. Jika nilainya adalah null, hanya terminator baris yang ditulis.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ObjectDisposedException

Penulis aliran dibuang.

InvalidOperationException

Penulis aliran saat ini sedang digunakan oleh operasi tulis sebelumnya.

Contoh

Contoh berikut menunjukkan cara menulis dua baris yang terdiri dari nilai string ke file teks dengan menggunakan WriteLineAsync(String) metode .

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

Keterangan

Terminator baris ditentukan oleh TextWriter.NewLine properti .

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

WriteLineAsync(Char[], Int32, Int32)

Sumber:

StreamWriter.cs

Secara asinkron menulis subarray karakter ke aliran, diikuti oleh terminator garis.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer, int index, int count);

public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);

override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As Task

Parameter

buffer

Char[]

Array karakter untuk menulis data.

index

Int32

Posisi karakter dalam buffer untuk mulai membaca data.

count

Int32

Jumlah maksimum karakter yang akan ditulis.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ArgumentNullException

bufferadalah null.

ArgumentException

Plus indexcount lebih besar dari panjang buffer.

ArgumentOutOfRangeException

index atau count negatif.

ObjectDisposedException

Penulis aliran dibuang.

InvalidOperationException

Penulis aliran saat ini sedang digunakan oleh operasi tulis sebelumnya.

Contoh

Contoh berikut menunjukkan cara menulis karakter ke dua baris terpisah dalam file teks dengan menggunakan WriteLineAsync(Char[], Int32, Int32) metode . Baris pertama berisi 11 karakter pertama dari string (huruf "Baris pertama" diikuti dengan spasi). Baris kedua berisi karakter yang tersisa dari string (huruf "dan baris kedua").

using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program6
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            UnicodeEncoding ue = new UnicodeEncoding();
            char[] charsToAdd = ue.GetChars(ue.GetBytes("First line and second line"));
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync(charsToAdd, 0, 11);
                await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim ue As UnicodeEncoding = New UnicodeEncoding()
        Dim charsToAdd() = ue.GetChars(ue.GetBytes("First line and second line"))

        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(charsToAdd, 0, 11)
            Await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11)
        End Using
    End Sub
End Module

Keterangan

Terminator baris ditentukan oleh TextWriter.NewLine properti .