StringWriter.WriteLineAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

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

Overload

WriteLineAsync(StringBuilder, CancellationToken)	Secara asinkron menulis representasi string penyusun string ke string saat ini, diikuti dengan terminator baris.
WriteLineAsync(Char)	Secara asinkron menulis karakter ke string, diikuti oleh terminator garis.
WriteLineAsync(String)	Secara asinkron menulis string ke string saat ini, diikuti oleh terminator baris.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Secara asinkron menulis representasi string dari wilayah memori karakter ke string saat ini, diikuti oleh terminator baris.
WriteLineAsync(Char[], Int32, Int32)	secara asinkron menulis subarray karakter ke string, diikuti dengan terminator baris.

WriteLineAsync(StringBuilder, CancellationToken)

Sumber:

StringWriter.cs

Secara asinkron menulis representasi string penyusun string ke string saat ini, diikuti dengan terminator baris.

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

override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

value

StringBuilder

Pembangun string untuk menulis ke string.

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

WriteLineAsync(Char)

Sumber:

StringWriter.cs

Secara asinkron menulis karakter ke string, 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 string.

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

ObjectDisposedException

Penulis string dibuang.

InvalidOperationException

Penulis string saat ini sedang digunakan oleh operasi tulis sebelumnya.

Contoh

Contoh berikut menunjukkan cara menulis karakter dengan menggunakan WriteLineAsync(Char) metode .

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));
                foreach (char c in charsToAdd)
                {
                    await writer.WriteLineAsync(c);
                }
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// a
// n
// d
//
// c
// h
// a
// r
// s
//
// t
// o
//
// a
// d
// d
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))
            For Each c As Char In charsToAdd
                Await writer.WriteLineAsync(c)
            Next
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' a
' n
' d 
'
' c
' h
' a
' r
' s
' 
' t
' o
'
' a
' d
' d
'

Keterangan

Terminator baris ditentukan oleh NewLine properti .

WriteLineAsync(String)

Sumber:

StringWriter.cs

Secara asinkron menulis string ke string saat ini, diikuti oleh terminator baris.

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 string dibuang.

InvalidOperationException

Penulis string saat ini sedang digunakan oleh operasi tulis sebelumnya.

Contoh

Contoh berikut menunjukkan cara menulis string dengan menggunakan WriteLineAsync(String) metode .

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                await writer.WriteLineAsync("and add characters through StringWriter");
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and add characters through StringWriter
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)
            Await writer.WriteLineAsync("and add characters through StringWriter")
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and add characters through StringWriter
'

Keterangan

Terminator baris ditentukan oleh NewLine properti .

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Sumber:

StringWriter.cs

Secara asinkron menulis representasi string dari wilayah memori karakter ke string saat ini, 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 ditulis ke string.

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.

WriteLineAsync(Char[], Int32, Int32)

Sumber:

StringWriter.cs

secara asinkron menulis subarray karakter ke string, diikuti dengan terminator baris.

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 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 string dibuang.

InvalidOperationException

Penulis string saat ini sedang digunakan oleh operasi tulis sebelumnya.

Contoh

Contoh berikut menunjukkan cara menulis karakter dengan menggunakan WriteLineAsync(Char[], Int32, Int32) metode .

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));

                await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length);

                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))

            Await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length)

            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and chars to add
'

Keterangan

Terminator baris ditentukan oleh NewLine properti .