StreamWriter.WriteLineAsync Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Schreibt Daten, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.

Überlädt

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Schreibt die Textdarstellung eines Zeichenspeicherbereichs, gefolgt von einem Zeilenabschlusszeichen, asynchron in den Datenstrom.
WriteLineAsync()	Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Datenstrom.
WriteLineAsync(Char)	Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.
WriteLineAsync(String)	Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.
WriteLineAsync(Char[], Int32, Int32)	Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in denn Datenstrom.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Quelle:

StreamWriter.cs

Schreibt die Textdarstellung eines Zeichenspeicherbereichs, gefolgt von einem Zeilenabschlusszeichen, asynchron in den Datenstrom.

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>

Der Zeichenspeicherbereich, der in den Datenstrom geschrieben werden soll.

cancellationToken

CancellationToken

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

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

OperationCanceledException

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

Hinweise

Das Zeilenabschlusszeichen wird durch das CoreNewLine Feld definiert.

WriteLineAsync()

Quelle:

StreamWriter.cs

Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Datenstrom.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync();

public override System.Threading.Tasks.Task WriteLineAsync ();

override this.WriteLineAsync : unit -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync () As Task

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ObjectDisposedException

Der Streamwriter wird freigegeben.

InvalidOperationException

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Das Zeilenabschlusszeichen wird durch die TextWriter.NewLine -Eigenschaft definiert.

WriteLineAsync(Char)

Quelle:

StreamWriter.cs

Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.

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

Das in den Stream zu schreibende Zeichen.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ObjectDisposedException

Der Streamwriter wird freigegeben.

InvalidOperationException

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Das folgende Beispiel zeigt, wie ein einzelnes Zeichen (der Buchstabe "a") mithilfe der -Methode in eine Zeile in einer Textdatei geschrieben wird, gefolgt von einer weiteren Zeile, die WriteLineAsync(Char) ein einzelnes Zeichen (den Buchstaben "b") enthält.

using System.IO;

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

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

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim firstChar As Char = "a"
        Dim secondChar As Char = "b"
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(firstChar)
            Await writer.WriteLineAsync(secondChar)
        End Using
    End Sub
End Module

Hinweise

Das Zeilenabschlusszeichen wird durch die TextWriter.NewLine -Eigenschaft definiert.

WriteLineAsync(String)

Quelle:

StreamWriter.cs

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.

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

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

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ObjectDisposedException

Der Streamwriter wird freigegeben.

InvalidOperationException

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Im folgenden Beispiel wird gezeigt, wie zwei Zeilen, die aus Zeichenfolgenwerten bestehen, mithilfe der WriteLineAsync(String) -Methode in eine Textdatei geschrieben werden.

using System.IO;

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

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}

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.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

Hinweise

Das Zeilenabschlusszeichen wird durch die TextWriter.NewLine -Eigenschaft definiert.

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

WriteLineAsync(Char[], Int32, Int32)

Quelle:

StreamWriter.cs

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in denn Datenstrom.

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

Das Zeichenarray, aus dem Daten geschrieben werden sollen.

index

Int32

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

count

Int32

Die maximale Anzahl der zu schreibenden Zeichen.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

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

ArgumentOutOfRangeException

index oder count ist ein negativer Wert.

ObjectDisposedException

Der Streamwriter wird freigegeben.

InvalidOperationException

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Das folgende Beispiel zeigt, wie Zeichen mithilfe der WriteLineAsync(Char[], Int32, Int32) -Methode in zwei separate Zeilen in einer Textdatei geschrieben werden. Die erste Zeile enthält die ersten 11 Zeichen aus der Zeichenfolge (die Buchstaben "Erste Zeile" gefolgt von einem Leerzeichen). Die zweite Zeile enthält die verbleibenden Zeichen aus der Zeichenfolge (die Buchstaben "und zweite Zeile").

using System.IO;
using System.Text;

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

        static async void WriteCharacters()
        {
            UnicodeEncoding ue = new UnicodeEncoding();
            char[] charsToAdd = ue.GetChars(ue.GetBytes("First line and second line"));
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync(charsToAdd, 0, 11);
                await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11);
            }
        }
    }
}

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("First line and second line"))

        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(charsToAdd, 0, 11)
            Await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11)
        End Using
    End Sub
End Module

Hinweise

Das Zeilenabschlusszeichen wird durch die TextWriter.NewLine -Eigenschaft definiert.