Freigeben über


StringWriter.WriteLineAsync Methode

Definition

Schreibt Daten, gefolgt von einem Zeilenabschlusszeichen, asynchron in die Zeichenfolge.

Überlädt

WriteLineAsync(StringBuilder, CancellationToken)

Schreibt die Zeichenfolgendarstellung des Zeichenfolgengenerators, gefolgt von einem Zeilenabschlusszeichen, asynchron in die aktuelle Zeichenfolge.

WriteLineAsync(Char)

Schreibt ein Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in die Zeichenfolge.

WriteLineAsync(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeilenabschlusszeichen, asynchron in die aktuelle Zeichenfolge.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt die Zeichenfolgendarstellung des Zeichenspeicherbereichs, gefolgt von einem Zeilenabschlusszeichen, asynchron in die aktuelle Zeichenfolge.

WriteLineAsync(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in die Zeichenfolge.

WriteLineAsync(StringBuilder, CancellationToken)

Quelle:
StringWriter.cs
Quelle:
StringWriter.cs
Quelle:
StringWriter.cs

Schreibt die Zeichenfolgendarstellung des Zeichenfolgengenerators, gefolgt von einem Zeilenabschlusszeichen, asynchron in die aktuelle Zeichenfolge.

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

Der Zeichenfolgengenerator, der in die Zeichenfolge geschrieben werden soll.

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteLine(StringBuilder).

Gilt für:

WriteLineAsync(Char)

Quelle:
StringWriter.cs
Quelle:
StringWriter.cs
Quelle:
StringWriter.cs

Schreibt ein Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in die Zeichenfolge.

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

Das in die Zeichenfolge zu schreibende Zeichen.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der StringWriter wird verworfen.

Der StringWriter wird zurzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Zeichen mithilfe der WriteLineAsync(Char) -Methode geschrieben werden.

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
'

Hinweise

Das Zeilenabschlusszeichen wird durch die NewLine -Eigenschaft definiert.

Gilt für:

WriteLineAsync(String)

Quelle:
StringWriter.cs
Quelle:
StringWriter.cs
Quelle:
StringWriter.cs

Schreibt eine Zeichenfolge, gefolgt von einem Zeilenabschlusszeichen, asynchron in die aktuelle Zeichenfolge.

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

Die zu schreibende Zeichenfolge. Wenn der Wert null ist, wird nur ein Zeichen für den Zeilenabschluss geschrieben.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

Der StringWriter wird verworfen.

Der StringWriter wird zurzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Im folgenden Beispiel wird gezeigt, wie eine Zeichenfolge mithilfe der WriteLineAsync(String) -Methode geschrieben wird.

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
'

Hinweise

Das Zeilenabschlusszeichen wird durch die NewLine -Eigenschaft definiert.

Gilt für:

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Quelle:
StringWriter.cs
Quelle:
StringWriter.cs
Quelle:
StringWriter.cs

Schreibt die Zeichenfolgendarstellung des Zeichenspeicherbereichs, gefolgt von einem Zeilenabschlusszeichen, asynchron in die aktuelle Zeichenfolge.

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>

Ein Zeichenspeicherbereich, der in die Zeichenfolge geschrieben werden soll.

cancellationToken
CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Gilt für:

WriteLineAsync(Char[], Int32, Int32)

Quelle:
StringWriter.cs
Quelle:
StringWriter.cs
Quelle:
StringWriter.cs

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in die Zeichenfolge.

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[]

Das Zeichenarray, aus dem Daten geschrieben werden sollen.

index
Int32

Die Position im Puffer, an der mit dem Lesen von Daten begonnen werden soll.

count
Int32

Die maximale Anzahl der zu schreibenden Zeichen.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute

Ausnahmen

buffer ist null.

index plus count ist größer als die Pufferlänge.

index oder count ist ein negativer Wert.

Der StringWriter wird verworfen.

Der StringWriter wird zurzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Zeichen mithilfe der WriteLineAsync(Char[], Int32, Int32) -Methode geschrieben werden.

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
'

Hinweise

Das Zeilenabschlusszeichen wird durch die NewLine -Eigenschaft definiert.

Gilt für: