StreamWriter.WriteLineAsync Método

Definición

Escribe de forma asincrónica datos en la secuencia, seguidos de un terminador de línea.Asynchronously writes data to the stream, followed by a line terminator.

Sobrecargas

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Escribe de forma asincrónica la representación en forma de texto de una región de memoria de caracteres en la secuencia, seguida de un terminador de línea.Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

WriteLineAsync()

Escribe de forma asincrónica un terminador de línea en la secuencia.Asynchronously writes a line terminator to the stream.

WriteLineAsync(Char)

Escribe de forma asincrónica un carácter en la secuencia, seguido de un terminador de línea.Asynchronously writes a character to the stream, followed by a line terminator.

WriteLineAsync(String)

Escribe de forma asincrónica una cadena en la secuencia, seguida de un terminador de línea.Asynchronously writes a string to the stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32)

Escribe de forma asincrónica una submatriz de caracteres en la secuencia, seguida de un terminador de línea.Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Escribe de forma asincrónica la representación en forma de texto de una región de memoria de caracteres en la secuencia, seguida de un terminador de línea.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 = 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

Parámetros

buffer
ReadOnlyMemory<Char>

Región de memoria de caracteres que se va a escribir en la secuencia.The character memory region to write to the stream.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación.The token to monitor for cancellation requests. El valor predeterminado es None.The default value is None.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.A task that represents the asynchronous write operation.

Comentarios

El terminador de línea está definido por el CoreNewLine campo.The line terminator is defined by the CoreNewLine field.

Se aplica a

WriteLineAsync()

Escribe de forma asincrónica un terminador de línea en la secuencia.Asynchronously writes a line terminator to the stream.

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

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.A task that represents the asynchronous write operation.

Atributos

Excepciones

Se desecha el sistema de escritura de secuencias.The stream writer is disposed.

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.The stream writer is currently in use by a previous write operation.

Comentarios

La propiedad define el terminador de línea TextWriter.NewLine .The line terminator is defined by the TextWriter.NewLine property.

Se aplica a

WriteLineAsync(Char)

Escribe de forma asincrónica un carácter en la secuencia, seguido de un terminador de línea.Asynchronously writes a character to the stream, followed by a line terminator.

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

Parámetros

value
Char

Carácter que se va a escribir en la secuencia.The character to write to the stream.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.A task that represents the asynchronous write operation.

Atributos

Excepciones

Se desecha el sistema de escritura de secuencias.The stream writer is disposed.

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.The stream writer is currently in use by a previous write operation.

Ejemplos

En el ejemplo siguiente se muestra cómo escribir un único carácter (la letra "a") en una línea de un archivo de texto, seguido de otra línea que contiene un solo carácter (la letra "b"), mediante el WriteLineAsync(Char) método.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

Comentarios

La propiedad define el terminador de línea TextWriter.NewLine .The line terminator is defined by the TextWriter.NewLine property.

Se aplica a

WriteLineAsync(String)

Escribe de forma asincrónica una cadena en la secuencia, seguida de un terminador de línea.Asynchronously writes a string to the stream, followed by a line terminator.

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

Parámetros

value
String

Cadena que se va a escribir.The string to write. Si el valor es null, solo se escribe el terminador de línea.If the value is null, only a line terminator is written.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.A task that represents the asynchronous write operation.

Atributos

Excepciones

Se desecha el sistema de escritura de secuencias.The stream writer is disposed.

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.The stream writer is currently in use by a previous write operation.

Ejemplos

En el ejemplo siguiente se muestra cómo escribir dos líneas que se componen de valores de cadena en un archivo de texto mediante el WriteLineAsync(String) método.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

Comentarios

La propiedad define el terminador de línea TextWriter.NewLine .The line terminator is defined by the TextWriter.NewLine property.

Se aplica a

WriteLineAsync(Char[], Int32, Int32)

Escribe de forma asincrónica una submatriz de caracteres en la secuencia, seguida de un terminador de línea.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);
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

Parámetros

buffer
Char[]

Matriz de caracteres de la que se escriben los datos.The character array to write data from.

index
Int32

Posición del carácter en el búfer donde comenzar la lectura de datos.The character position in the buffer at which to start reading data.

count
Int32

Número máximo de caracteres que se van a escribir.The maximum number of characters to write.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.A task that represents the asynchronous write operation.

Atributos

Excepciones

buffer es null.buffer is null.

index más count es mayor que la longitud del búfer.The index plus count is greater than the buffer length.

index o count es negativo.index or count is negative.

Se desecha el sistema de escritura de secuencias.The stream writer is disposed.

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.The stream writer is currently in use by a previous write operation.

Ejemplos

En el ejemplo siguiente se muestra cómo escribir caracteres en dos líneas independientes en un archivo de texto mediante el WriteLineAsync(Char[], Int32, Int32) método.The following example shows how to write characters to two separate lines in a text file by using the WriteLineAsync(Char[], Int32, Int32) method. La primera línea contiene los 11 primeros caracteres de la cadena (las letras "primera línea" seguidas de un espacio).The first line contains the first 11 characters from the string (the letters "First line" followed by a space). La segunda línea contiene el resto de los caracteres de la cadena (las letras "y la segunda línea").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

Comentarios

La propiedad define el terminador de línea TextWriter.NewLine .The line terminator is defined by the TextWriter.NewLine property.

Se aplica a