StringWriter.WriteLineAsync Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

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

Sobrecargas

WriteLineAsync(StringBuilder, CancellationToken)	Escribe de forma asincrónica la representación en forma de cadena del generador de cadena 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 de forma asincrónica la representación en forma 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 de forma asincrónica una submatriz 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 en forma de cadena del generador de cadena 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

El generador de cadena que se va a escribir en la cadena.

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

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, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver 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 cadena se elimina.

InvalidOperationException

Una operación de escritura anterior está usando actualmente el escritor de cadena.

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 el terminador de línea.

Devoluciones

Task

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

Excepciones

ObjectDisposedException

El escritor de cadena se elimina.

InvalidOperationException

Una operación de escritura anterior está usando actualmente el escritor de cadena.

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 de forma asincrónica la representación en forma 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>

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

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.

WriteLineAsync(Char[], Int32, Int32)

Source:

StringWriter.cs

Escribe de forma asincrónica una submatriz 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 de la que se escriben los datos.

index

Int32

Posición 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

El escritor de cadena se elimina.

InvalidOperationException

Una operación de escritura anterior está usando actualmente el escritor de cadena.

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 .