Bagikan melalui


StreamWriter.WriteLineAsync Metode

Definisi

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
Sumber:
StreamWriter.cs
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

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

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

Keterangan

Terminator garis ditentukan oleh CoreNewLine bidang .

Berlaku untuk

WriteLineAsync()

Sumber:
StreamWriter.cs
Sumber:
StreamWriter.cs
Sumber:
StreamWriter.cs

Secara asinkron menulis terminator baris ke aliran.

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

Mengembalikan

Tugas yang mewakili operasi tulis asinkron.

Atribut

Pengecualian

Penulis aliran dibuang.

Penulis aliran saat ini sedang digunakan oleh operasi tulis sebelumnya.

Keterangan

Terminator baris ditentukan oleh TextWriter.NewLine properti .

Berlaku untuk

WriteLineAsync(Char)

Sumber:
StreamWriter.cs
Sumber:
StreamWriter.cs
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);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (char value);
override this.WriteLineAsync : char -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Tugas yang mewakili operasi tulis asinkron.

Atribut

Pengecualian

Penulis aliran dibuang.

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 .

Berlaku untuk

WriteLineAsync(String)

Sumber:
StreamWriter.cs
Sumber:
StreamWriter.cs
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);
public override System.Threading.Tasks.Task WriteLineAsync (string? value);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (string value);
override this.WriteLineAsync : string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Tugas yang mewakili operasi tulis asinkron.

Atribut

Pengecualian

Penulis aliran dibuang.

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

Berlaku untuk

WriteLineAsync(Char[], Int32, Int32)

Sumber:
StreamWriter.cs
Sumber:
StreamWriter.cs
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);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Tugas yang mewakili operasi tulis asinkron.

Atribut

Pengecualian

bufferadalah null.

Plus indexcount lebih besar dari panjang buffer.

index atau count negatif.

Penulis aliran dibuang.

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 .

Berlaku untuk