StreamWriter.WriteLineAsync Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Escribe de forma asincrónica datos en la secuencia, seguidos de un terminador de línea.

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.
WriteLineAsync()	Escribe de forma asincrónica un terminador de línea en la secuencia.
WriteLineAsync(Char)	Escribe de forma asincrónica un carácter en la secuencia, seguido de un terminador de línea.
WriteLineAsync(String)	Escribe de forma asincrónica una cadena en la secuencia, seguida de un terminador de línea.
WriteLineAsync(Char[], Int32, Int32)	Escribe de forma asincrónica una submatriz de caracteres en la secuencia, seguida de un terminador de línea.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Source:

StreamWriter.cs

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.

C#

public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

Parámetros

buffer

ReadOnlyMemory<Char>

Región de memoria de caracteres que se va a escribir en la secuencia.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

El terminador de línea se define mediante el CoreNewLine campo .

WriteLineAsync()

Source:

StreamWriter.cs

Escribe de forma asincrónica un terminador de línea en la secuencia.

C#

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

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

ObjectDisposedException

Se desecha el sistema de escritura de secuencias.

InvalidOperationException

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.

Comentarios

El terminador de línea se define mediante la TextWriter.NewLine propiedad .

WriteLineAsync(Char)

Source:

StreamWriter.cs

Escribe de forma asincrónica un carácter en la secuencia, seguido de un terminador de línea.

C#

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

Parámetros

value

Char

Carácter que se va a escribir en la secuencia.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

ObjectDisposedException

Se desecha el sistema de escritura de secuencias.

InvalidOperationException

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.

Ejemplos

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

C#

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');
            }
        }
    }
}

Comentarios

El terminador de línea se define mediante la TextWriter.NewLine propiedad .

WriteLineAsync(String)

Source:

StreamWriter.cs

Escribe de forma asincrónica una cadena en la secuencia, seguida de un terminador de línea.

C#

public override System.Threading.Tasks.Task WriteLineAsync (string? value);

Parámetros

value

String

Cadena que se va a escribir. Si el valor es null, solo se escribe el terminador de línea.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

ObjectDisposedException

Se desecha el sistema de escritura de secuencias.

InvalidOperationException

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.

Ejemplos

En el ejemplo siguiente se muestra cómo escribir dos líneas que constan de valores de cadena en un archivo de texto mediante el WriteLineAsync(String) método .

C#

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");
            }
        }
    }
}

Comentarios

El terminador de línea se define mediante la TextWriter.NewLine propiedad .

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por WriteLine(String).

WriteLineAsync(Char[], Int32, Int32)

Source:

StreamWriter.cs

Escribe de forma asincrónica una submatriz de caracteres en la secuencia, seguida de un terminador de línea.

C#

public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);

Parámetros

buffer

Char[]

Matriz de caracteres de la que se escriben los datos.

index

Int32

Posición del carácter en el búfer donde comenzar la lectura de datos.

count

Int32

Número máximo de caracteres que se van a escribir.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

ArgumentNullException

buffer es null.

ArgumentException

index más count es mayor que la longitud del búfer.

ArgumentOutOfRangeException

index o count es negativo.

ObjectDisposedException

Se desecha el sistema de escritura de secuencias.

InvalidOperationException

El escritor de secuencias está actualmente en uso por una operación de escritura anterior.

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 . La primera línea contiene los primeros 11 caracteres de la cadena (las letras "Primera línea" seguidas de un espacio). La segunda línea contiene los caracteres restantes de la cadena (las letras "y la segunda línea").

C#

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);
            }
        }
    }
}

Comentarios

El terminador de línea se define mediante la TextWriter.NewLine propiedad .