StringWriter.WriteLineAsync Metódus

Definíció

Névtér:

System.IO

Szerelvények:

netstandard.dll, System.Runtime.dll

Aszinkron módon adatokat ír a sztringbe, majd egy sor terminátort.

Túlterhelések

Name	Description
WriteLineAsync(StringBuilder, CancellationToken)	Aszinkron módon írja a sztringszerkesztő sztringképét az aktuális sztringre, amelyet egy sor terminátor követ.
WriteLineAsync(Char)	Aszinkron módon egy karaktert ír a sztringbe, majd egy sor terminátort.
WriteLineAsync(String)	Aszinkron módon egy sztringet ír az aktuális sztringre, amelyet egy sor terminátor követ.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Aszinkron módon írja a karakterek memóriaterületének sztringképét az aktuális sztringre, majd egy sor terminátort.
WriteLineAsync(Char[], Int32, Int32)	aszinkron módon a karakterek egy részarráját írja a sztringbe, amelyet egy sor terminátor követ.

WriteLineAsync(StringBuilder, CancellationToken)

Forrás:

StringWriter.cs

Aszinkron módon írja a sztringszerkesztő sztringképét az aktuális sztringre, amelyet egy sor terminátor követ.

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

Paraméterek

value

StringBuilder

A sztringszerkesztő, amely a sztringbe ír.

cancellationToken

CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által WriteLine(StringBuilder)kiadott kivételeket: .

WriteLineAsync(Char)

Forrás:

StringWriter.cs

Aszinkron módon egy karaktert ír a sztringbe, majd egy sor terminátort.

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

Paraméterek

value

Char

A sztringbe írni kívánt karakter.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

ObjectDisposedException

A sztring írója el van dobva.

InvalidOperationException

A sztringírót jelenleg egy korábbi írási művelet használja.

Példák

Az alábbi példa bemutatja, hogyan írhat karaktereket a WriteLineAsync(Char) metódus használatával.

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
'

Megjegyzések

A sor terminátorát a NewLine tulajdonság határozza meg.

WriteLineAsync(String)

Forrás:

StringWriter.cs

Aszinkron módon egy sztringet ír az aktuális sztringre, amelyet egy sor terminátor követ.

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

Paraméterek

value

String

Az írandó sztring. Ha az érték az null, akkor csak egy sor terminátora lesz megírva.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

ObjectDisposedException

A sztring írója el van dobva.

InvalidOperationException

A sztringírót jelenleg egy korábbi írási művelet használja.

Példák

Az alábbi példa bemutatja, hogyan írhat sztringet a WriteLineAsync(String) metódus használatával.

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
'

Megjegyzések

A sor terminátorát a NewLine tulajdonság határozza meg.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Forrás:

StringWriter.cs

Aszinkron módon írja a karakterek memóriaterületének sztringképét az aktuális sztringre, majd egy sor terminátort.

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

Paraméterek

buffer

ReadOnlyMemory<Char>

A sztringbe írni kívánt karakterek memóriaterülete.

cancellationToken

CancellationToken

A lemondási kérelmek figyelésére szolgáló jogkivonat. Az alapértelmezett érték a None.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

WriteLineAsync(Char[], Int32, Int32)

Forrás:

StringWriter.cs

aszinkron módon a karakterek egy részarráját írja a sztringbe, amelyet egy sor terminátor követ.

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

Paraméterek

buffer

Char[]

A karaktertömb, amelyből adatokat írhat.

index

Int32

Az a pozíció a pufferben, ahol megkezdi az adatok olvasását.

count

Int32

Az írandó karakterek maximális száma.

Válaszok

Task

Az aszinkron írási műveletet képviselő feladat.

Kivételek

ArgumentNullException

buffer az null.

ArgumentException

A index plusz count nagyobb, mint a puffer hossza.

ArgumentOutOfRangeException

index vagy count negatív.

ObjectDisposedException

A sztring írója el van dobva.

InvalidOperationException

A sztringírót jelenleg egy korábbi írási művelet használja.

Példák

Az alábbi példa bemutatja, hogyan írhat karaktereket a WriteLineAsync(Char[], Int32, Int32) metódus használatával.

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
'

Megjegyzések

A sor terminátorát a NewLine tulajdonság határozza meg.