TextWriter.WriteAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

netstandard.dll, System.Runtime.dll

Menulis data ke aliran teks secara asinkron.

Overload

Nama	Deskripsi
WriteAsync(Char[], Int32, Int32)	Menulis subarray karakter ke aliran teks secara asinkron.
WriteAsync(StringBuilder, CancellationToken)	Menulis pembangun string secara asinkron ke aliran teks.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Menulis wilayah memori karakter secara asinkron ke aliran teks.
WriteAsync(Char)	Menulis karakter ke aliran teks secara asinkron.
WriteAsync(String)	Menulis string ke aliran teks secara asinkron.
WriteAsync(Char[])	Menulis array karakter ke aliran teks secara asinkron.

WriteAsync(Char[], Int32, Int32)

Sumber:

TextWriter.cs

Menulis subarray karakter ke aliran teks secara asinkron.

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

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

abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (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 mengambil data.

count

Int32

Jumlah karakter yang akan ditulis.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ArgumentNullException

buffer adalah null.

ArgumentException

Nilai index plusnya count lebih besar dari panjang buffer.

ArgumentOutOfRangeException

index atau count negatif.

ObjectDisposedException

Penulis teks dibuang.

InvalidOperationException

Penulis teks saat ini sedang digunakan oleh operasi tulis sebelumnya.

Keterangan

Kelas TextWriter ini adalah kelas abstrak. Oleh karena itu, Anda tidak membuat instans dalam kode Anda. Untuk contoh penggunaan metode , WriteAsync lihat StreamWriter.WriteAsync metode .

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 Write(Char[], Int32, Int32).

Lihat juga

• WriteAsync(Char[], Int32, Int32)
• WriteAsync(Char[], Int32, Int32)

WriteAsync(StringBuilder, CancellationToken)

Sumber:

TextWriter.cs

Menulis pembangun string secara asinkron ke aliran teks.

public virtual System.Threading.Tasks.Task WriteAsync(System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

value

StringBuilder

String, sebagai penyusun string, untuk menulis ke aliran teks.

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

Metode ini setara dengan panggilan WriteAsync(stringBuilder.ToString()), namun, metode ini menggunakan StringBuilder.GetChunks() metode untuk menghindari pembuatan string perantara.

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Sumber:

TextWriter.cs

Menulis wilayah memori karakter secara asinkron ke aliran teks.

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

abstract member WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

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

Parameter

buffer

ReadOnlyMemory<Char>

Wilayah memori karakter untuk menulis ke aliran teks.

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.

WriteAsync(Char)

Sumber:

TextWriter.cs

Menulis karakter ke aliran teks secara asinkron.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);

public virtual System.Threading.Tasks.Task WriteAsync(char value);

abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As Char) As Task

Parameter

value

Char

Karakter untuk menulis ke aliran teks.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ObjectDisposedException

Penulis teks dibuang.

InvalidOperationException

Penulis teks saat ini sedang digunakan oleh operasi tulis sebelumnya.

Keterangan

Kelas TextWriter ini adalah kelas abstrak. Oleh karena itu, Anda tidak membuat instans dalam kode Anda. Untuk contoh penggunaan metode , WriteAsync lihat StreamWriter.WriteAsync metode .

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

Lihat juga

• WriteAsync(Char)
• WriteAsync(Char)

WriteAsync(String)

Sumber:

TextWriter.cs

Menulis string ke aliran teks secara asinkron.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);

public virtual System.Threading.Tasks.Task WriteAsync(string? value);

abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As String) As Task

Parameter

value

String

String yang akan ditulis. Jika value adalah null, tidak ada yang ditulis ke aliran teks.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ObjectDisposedException

Penulis teks dibuang.

InvalidOperationException

Penulis teks saat ini sedang digunakan oleh operasi tulis sebelumnya.

Keterangan

Kelas TextWriter ini adalah kelas abstrak. Oleh karena itu, Anda tidak membuat instans dalam kode Anda. Untuk contoh penggunaan metode , WriteAsync lihat StreamWriter.WriteAsync metode .

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

Lihat juga

• WriteAsync(String)
• WriteAsync(String)

WriteAsync(Char[])

Sumber:

TextWriter.cs

Menulis array karakter ke aliran teks secara asinkron.

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);

public System.Threading.Tasks.Task WriteAsync(char[]? buffer);

member this.WriteAsync : char[] -> System.Threading.Tasks.Task

Public Function WriteAsync (buffer As Char()) As Task

Parameter

buffer

Char[]

Array karakter untuk menulis ke aliran teks. Jika buffer adalah null, tidak ada yang ditulis.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ObjectDisposedException

Penulis teks dibuang.

InvalidOperationException

Penulis teks saat ini sedang digunakan oleh operasi tulis sebelumnya.

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 Write(Char[]).

Lihat juga

• StreamWriter
• StringWriter