StringWriter.WriteLineAsync Método

Definición

Espacio de nombres:

System.IO

Ensamblados:

netstandard.dll, System.Runtime.dll

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

Sobrecargas

Nombre	Description
WriteLineAsync(StringBuilder, CancellationToken)	Escribe de forma asincrónica la representación de cadena del generador de cadenas en la cadena actual, seguida de un terminador de línea.
WriteLineAsync(Char)	Escribe de forma asincrónica un carácter en la cadena, seguido de un terminador de línea.
WriteLineAsync(String)	Escribe de forma asincrónica una cadena en la cadena actual, seguida de un terminador de línea.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Escribe asincrónicamente la representación de cadena de la región de memoria de caracteres en la cadena actual, seguida de un terminador de línea.
WriteLineAsync(Char[], Int32, Int32)	escribe asincrónicamente una subbarray de caracteres en la cadena, seguida de un terminador de línea.

WriteLineAsync(StringBuilder, CancellationToken)

Source:

StringWriter.cs

Escribe de forma asincrónica la representación de cadena del generador de cadenas en la cadena actual, seguida de un terminador de línea.

public override System.Threading.Tasks.Task WriteLineAsync(System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

value

StringBuilder

Generador de cadenas que se va a escribir en la cadena.

cancellationToken

CancellationToken

Token que se va a supervisar para las 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

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por WriteLine(StringBuilder).

WriteLineAsync(Char)

Source:

StringWriter.cs

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

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

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

Parámetros

value

Char

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

Devoluciones

Task

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

Excepciones

ObjectDisposedException

El escritor de cadenas se elimina.

InvalidOperationException

El escritor de cadenas está actualmente en uso mediante una operación de escritura anterior.

Ejemplos

En el ejemplo siguiente se muestra cómo escribir caracteres mediante el WriteLineAsync(Char) método .

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));
                foreach (char c in charsToAdd)
                {
                    await writer.WriteLineAsync(c);
                }
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// a
// n
// d
//
// c
// h
// a
// r
// s
//
// t
// o
//
// a
// d
// d
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))
            For Each c As Char In charsToAdd
                Await writer.WriteLineAsync(c)
            Next
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' a
' n
' d 
'
' c
' h
' a
' r
' s
' 
' t
' o
'
' a
' d
' d
'

Comentarios

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

WriteLineAsync(String)

Source:

StringWriter.cs

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

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);

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

Parámetros

value

String

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

Devoluciones

Task

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

Excepciones

ObjectDisposedException

El escritor de cadenas se elimina.

InvalidOperationException

El escritor de cadenas está actualmente en uso mediante una operación de escritura anterior.

Ejemplos

En el ejemplo siguiente se muestra cómo escribir una cadena mediante el WriteLineAsync(String) método .

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                await writer.WriteLineAsync("and add characters through StringWriter");
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and add characters through StringWriter
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)
            Await writer.WriteLineAsync("and add characters through StringWriter")
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and add characters through StringWriter
'

Comentarios

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

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Source:

StringWriter.cs

Escribe asincrónicamente la representación de cadena de la región de memoria de caracteres en la cadena actual, seguida de un terminador de línea.

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>

Una región de memoria de caracteres que se va a escribir en la cadena.

cancellationToken

CancellationToken

Token que se va a supervisar para las 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.

WriteLineAsync(Char[], Int32, Int32)

Source:

StringWriter.cs

escribe asincrónicamente una subbarray de caracteres en la cadena, seguida de un terminador de línea.

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

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 desde la que se van a escribir datos.

index

Int32

Posición en el búfer en la que se empiezan a leer los 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

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

ArgumentOutOfRangeException

index o count es negativo.

ObjectDisposedException

El escritor de cadenas se elimina.

InvalidOperationException

El escritor de cadenas está actualmente en uso mediante una operación de escritura anterior.

Ejemplos

En el ejemplo siguiente se muestra cómo escribir caracteres mediante el WriteLineAsync(Char[], Int32, Int32) método .

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));

                await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length);

                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))

            Await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length)

            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and chars to add
'

Comentarios

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