StreamWriter.WriteAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Secara asinkron menulis data ke aliran.

Overload

WriteAsync(Char)	Secara asinkron menulis karakter ke aliran.
WriteAsync(String)	Secara asinkron menulis string ke aliran.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Secara asinkron menulis wilayah memori karakter ke aliran.
WriteAsync(Char[], Int32, Int32)	Secara asinkron menulis subarray karakter ke aliran.

WriteAsync(Char)

Sumber:

StreamWriter.cs

Secara asinkron menulis karakter ke aliran.

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

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

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

Public Overrides Function WriteAsync (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 file teks dengan menggunakan WriteAsync(Char) metode .

using System.IO;

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

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

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim oneLetter As Char = "a"
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteAsync(oneLetter)
        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 Write(Char).

WriteAsync(String)

Sumber:

StreamWriter.cs

Secara asinkron menulis string ke aliran.

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

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

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

Public Overrides Function WriteAsync (value As String) As Task

Parameter

value

String

String yang akan ditulis ke aliran. Jika value adalah null, tidak ada 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 string ke file teks dengan menggunakan WriteAsync(String) metode .

using System.IO;

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

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync("Example text as string");
            }
        }
    }
}

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.WriteAsync("Example text as string")
        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 Write(String).

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Sumber:

StreamWriter.cs

Secara asinkron menulis wilayah memori karakter ke aliran.

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

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

Public Overrides 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.

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[], Int32, Int32)

Sumber:

StreamWriter.cs

Secara asinkron menulis subarray karakter ke aliran.

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

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

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

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

Parameter

buffer

Char[]

Array karakter yang berisi data yang akan ditulis.

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 beberapa karakter ke file teks dengan menggunakan WriteAsync(Char[], Int32, Int32) metode .

using System.IO;
using System.Text;

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

        static async void WriteCharacters()
        {
            UnicodeEncoding ue = new UnicodeEncoding();
            char[] charsToAdd = ue.GetChars(ue.GetBytes("Example string"));
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length);
            }
        }
    }
}

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("Example string"))

        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length)
        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 Write(Char[], Int32, Int32).