StreamWriter.WriteLineAsync StreamWriter.WriteLineAsync StreamWriter.WriteLineAsync StreamWriter.WriteLineAsync Method

Definition

Schreibt Daten, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.Asynchronously writes data to the stream, followed by a line terminator.

Überlädt

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt die Textdarstellung eines Zeichenspeicherbereichs, gefolgt von einem Zeilenabschlusszeichen, asynchron in den Datenstrom.Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Datenstrom.Asynchronously writes a line terminator to the stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.Asynchronously writes a character to the stream, followed by a line terminator.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.Asynchronously writes a string to the stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in denn Datenstrom.Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Schreibt die Textdarstellung eines Zeichenspeicherbereichs, gefolgt von einem Zeilenabschlusszeichen, asynchron in den Datenstrom.Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = null);
override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Parameter

buffer
ReadOnlyMemory<Char>

Der Zeichenspeicherbereich, der in den Datenstrom geschrieben werden soll.The character memory region to write to the stream.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Das Token zum Überwachen von Abbruchanforderungen.The token to monitor for cancellation requests. Der Standardwert ist Nonesein.The default value is None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Hinweise

Das Zeichen für den Zeilen Abschluss wird CoreNewLine durch das-Feld definiert.The line terminator is defined by the CoreNewLine field.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

Schreibt ein Zeichen für den Zeilenabschluss asynchron in den Datenstrom.Asynchronously writes a line terminator to the stream.

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
Public Overrides Function WriteLineAsync () As Task

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Ausnahmen

Der Streamwriter wird freigegeben.The stream writer is disposed.

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The stream writer is currently in use by a previous write operation.

Hinweise

Das Zeichen für den Zeilen Abschluss wird TextWriter.NewLine durch die-Eigenschaft definiert.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

Schreibt ein Zeichen, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.Asynchronously writes a character to the stream, followed by a line terminator.

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
Public Overrides Function WriteLineAsync (value As Char) As Task

Parameter

value
Char Char Char Char

Das in den Stream zu schreibende Zeichen.The character to write to the stream.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Ausnahmen

Der Streamwriter wird freigegeben.The stream writer is disposed.

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The stream writer is currently in use by a previous write operation.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein einzelnes Zeichen (der Buchstabe "a") in eine Zeile in einer Textdatei geschrieben wird, gefolgt von einer anderen Zeile, die ein einzelnes Zeichen (den Buchstaben "b") WriteLineAsync(Char) mit der-Methode enthält.The following example shows how to write a single character (the letter "a") to a line in a text file, followed by another line that contains a single character (the letter "b"), by using the WriteLineAsync(Char) method.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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 Zeichen für den Zeilen Abschluss wird TextWriter.NewLine durch die-Eigenschaft definiert.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

Schreibt eine Zeichenfolge, gefolgt von einem Zeichen für den Zeilenabschluss, asynchron in den Datenstrom.Asynchronously writes a string to the stream, followed by a line terminator.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);
[System.Runtime.InteropServices.ComVisible(false)]
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 String String String

Die zu schreibende Zeichenfolge.The string to write. Wenn der Wert null ist, wird nur ein Zeichen für den Zeilenabschluss geschrieben.If the value is null, only a line terminator is written.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Ausnahmen

Der Streamwriter wird freigegeben.The stream writer is disposed.

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The stream writer is currently in use by a previous write operation.

Beispiele

Im folgenden Beispiel wird gezeigt, wie mithilfe der WriteLineAsync(String) -Methode zwei Zeilen geschrieben werden, die aus Zeichen folgen Werten in eine Textdatei bestehen.The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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 Zeichen für den Zeilen Abschluss wird TextWriter.NewLine durch die-Eigenschaft definiert.The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen, gefolgt von einem Zeilenabschlusszeichen, asynchron in denn Datenstrom.Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <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
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.The character array to write data from.

index
Int32 Int32 Int32 Int32

Die Zeichenposition im Puffer, an der mit dem Lesen von Daten begonnen werden soll.The character position in the buffer at which to start reading data.

count
Int32 Int32 Int32 Int32

Die maximale Anzahl der zu schreibenden Zeichen.The maximum number of characters to write.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.A task that represents the asynchronous write operation.

Ausnahmen

index plus count ist größer als die Pufferlänge.The index plus count is greater than the buffer length.

index oder count ist ein negativer Wert.index or count is negative.

Der Streamwriter wird freigegeben.The stream writer is disposed.

Der Streamwriter wird derzeit von einem vorherigen Schreibvorgang verwendet.The stream writer is currently in use by a previous write operation.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie mithilfe der WriteLineAsync(Char[], Int32, Int32) -Methode Zeichen in eine Textdatei in zwei separate Zeilen schreiben.The following example shows how to write characters to two separate lines in a text file by using the WriteLineAsync(Char[], Int32, Int32) method. Die erste Zeile enthält die ersten 11 Zeichen aus der Zeichenfolge (die Buchstaben "erste Zeile" gefolgt von einem Leerzeichen).The first line contains the first 11 characters from the string (the letters "First line" followed by a space). Die zweite Zeile enthält die restlichen Zeichen aus der Zeichenfolge (Buchstaben und zweite Zeile).The second line contains the remaining characters from the string (the letters "and second line").

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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 Zeichen für den Zeilen Abschluss wird TextWriter.NewLine durch die-Eigenschaft definiert.The line terminator is defined by the TextWriter.NewLine property.

Gilt für: