StreamWriter.WriteLineAsync Methode

  • Referenz

Definition

Namespace:
System.IO
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll
Assembly:
System.IO.dll
Assembly:
mscorlib.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
Quelle:
StreamWriter.cs
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.

Gilt für:

WriteLineAsync()

Quelle:
StreamWriter.cs
Quelle:
StreamWriter.cs
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 ();
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync ();
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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.

Attribute
ComVisibleAttribute

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.

Gilt für:

WriteLineAsync(Char)

Quelle:
StreamWriter.cs
Quelle:
StreamWriter.cs
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);
[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 den Stream zu schreibende Zeichen.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute
ComVisibleAttribute

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.

Gilt für:

WriteLineAsync(String)

Quelle:
StreamWriter.cs
Quelle:
StreamWriter.cs
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);
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

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute
ComVisibleAttribute

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

Gilt für:

WriteLineAsync(Char[], Int32, Int32)

Quelle:
StreamWriter.cs
Quelle:
StreamWriter.cs
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);
[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 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.

Attribute
ComVisibleAttribute

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.

Gilt für: