StreamWriter.WriteLineAsync Methode

Definition

Namespace:: System.IO

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: netstandard.dll

Assemblys:: mscorlib.dll, System.IO.dll

Assembly:: System.IO.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt Daten asynchron in den Datenstrom, gefolgt von einem Zeilenterminator.

Überlädt

Name	Beschreibung
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Schreibt asynchron die Textdarstellung eines Zeichenspeicherbereichs in den Datenstrom, gefolgt von einem Zeilenterminator.
WriteLineAsync()	Schreibt asynchron einen Zeilenterminator in den Datenstrom.
WriteLineAsync(Char)	Schreibt asynchron ein Zeichen in den Datenstrom, gefolgt von einem Zeilenterminator.
WriteLineAsync(String)	Schreibt asynchron eine Zeichenfolge in den Datenstrom, gefolgt von einem Zeilenterminator.
WriteLineAsync(Char[], Int32, Int32)	Schreibt asynchron eine Unterarray von Zeichen in den Datenstrom, gefolgt von einem Zeilenterminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

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

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, das auf Abbruchanforderungen überwacht werden soll. 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

Der Zeilenendpunkt wird durch das CoreNewLine Feld definiert.

Gilt für:

WriteLineAsync()

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt asynchron einen Zeilenterminator 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 Stream-Writer ist verworfen.

InvalidOperationException

Der Stream Writer wird derzeit von einem vorherigen Schreibvorgang verwendet.

Hinweise

Der Zeilenendpunkt wird durch die TextWriter.NewLine Eigenschaft definiert.

Gilt für:

WriteLineAsync(Char)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt asynchron ein Zeichen in den Datenstrom, gefolgt von einem Zeilenterminator.

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 Zeichen, das in den Datenstrom geschrieben werden soll.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute: ComVisibleAttribute

Ausnahmen

ObjectDisposedException

Der Stream-Writer ist verworfen.

InvalidOperationException

Der Stream Writer wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

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

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

Der Zeilenendpunkt wird durch die TextWriter.NewLine Eigenschaft definiert.

Gilt für:

WriteLineAsync(String)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt asynchron eine Zeichenfolge in den Datenstrom, gefolgt von einem Zeilenterminator.

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 lautet null, wird nur ein Zeilenterminator geschrieben.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute: ComVisibleAttribute

Ausnahmen

ObjectDisposedException

Der Stream-Writer ist verworfen.

InvalidOperationException

Der Stream Writer wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

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

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

Der Zeilenendpunkt wird durch die TextWriter.NewLine Eigenschaft definiert.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteLine(String).

Gilt für:

WriteLineAsync(Char[], Int32, Int32)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt asynchron eine Unterarray von Zeichen in den Datenstrom, gefolgt von einem Zeilenterminator.

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 von Zeichen, die geschrieben werden sollen.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Attribute: ComVisibleAttribute

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

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

ArgumentOutOfRangeException

index oder count ist negativ.

ObjectDisposedException

Der Stream-Writer ist verworfen.

InvalidOperationException

Der Stream Writer wird derzeit von einem vorherigen Schreibvorgang verwendet.

Beispiele

Das folgende Beispiel zeigt, wie Zeichen mithilfe der WriteLineAsync(Char[], Int32, Int32) Methode in zwei getrennte 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

Der Zeilenendpunkt wird durch die TextWriter.NewLine Eigenschaft definiert.

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

StreamWriter.WriteLineAsync Methode

Definition

Überlädt

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

WriteLineAsync()

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

WriteLineAsync(Char)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

WriteLineAsync(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

WriteLineAsync(Char[], Int32, Int32)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback