TextWriter.WriteAsync Método

Definición

Espacio de nombres:

System.IO

Ensamblados:

netstandard.dll, System.Runtime.dll

Escribe datos en el flujo de texto de forma asincrónica.

Sobrecargas

Nombre	Description
WriteAsync(Char[], Int32, Int32)	Escribe una subbarra de caracteres en la secuencia de texto de forma asincrónica.
WriteAsync(StringBuilder, CancellationToken)	Escribe de forma asincrónica un generador de cadenas en la secuencia de texto.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Escribe de forma asincrónica una región de memoria de caracteres en la secuencia de texto.
WriteAsync(Char)	Escribe un carácter en la secuencia de texto de forma asincrónica.
WriteAsync(String)	Escribe una cadena en la secuencia de texto de forma asincrónica.
WriteAsync(Char[])	Escribe una matriz de caracteres en la secuencia de texto de forma asincrónica.

WriteAsync(Char[], Int32, Int32)

Source:

TextWriter.cs

Escribe una subbarra de caracteres en la secuencia de texto de forma asincrónica.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer, int index, int count);

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

abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (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 del carácter en el búfer en el que se van a empezar a recuperar datos.

count

Int32

Número 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

Se elimina el escritor de texto.

InvalidOperationException

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

Comentarios

La TextWriter clase es una clase abstracta. Por lo tanto, no se crea una instancia en el código. Para obtener un ejemplo del uso del WriteAsync método , vea el StreamWriter.WriteAsync método .

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 Write(Char[], Int32, Int32).

Consulte también

• WriteAsync(Char[], Int32, Int32)
• WriteAsync(Char[], Int32, Int32)

WriteAsync(StringBuilder, CancellationToken)

Source:

TextWriter.cs

Escribe de forma asincrónica un generador de cadenas en la secuencia de texto.

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

abstract member WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

Parámetros

value

StringBuilder

Cadena, como generador de cadenas, para escribir en la secuencia de texto.

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

Sin embargo, este método es equivalente a llamar WriteAsync(stringBuilder.ToString())a , pero usa el StringBuilder.GetChunks() método para evitar crear la cadena intermedia.

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 Write(StringBuilder).

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Source:

TextWriter.cs

Escribe de forma asincrónica una región de memoria de caracteres en la secuencia de texto.

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

abstract member WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (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 de texto.

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.

WriteAsync(Char)

Source:

TextWriter.cs

Escribe un carácter en la secuencia de texto de forma asincrónica.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);

public virtual System.Threading.Tasks.Task WriteAsync(char value);

abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As Char) As Task

Parámetros

value

Char

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

Devoluciones

Task

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

Excepciones

ObjectDisposedException

Se elimina el escritor de texto.

InvalidOperationException

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

Comentarios

La TextWriter clase es una clase abstracta. Por lo tanto, no se crea una instancia en el código. Para obtener un ejemplo del uso del WriteAsync método , vea el StreamWriter.WriteAsync método .

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 Write(Char).

Consulte también

• WriteAsync(Char)
• WriteAsync(Char)

WriteAsync(String)

Source:

TextWriter.cs

Escribe una cadena en la secuencia de texto de forma asincrónica.

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);

public virtual System.Threading.Tasks.Task WriteAsync(string? value);

abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As String) As Task

Parámetros

value

String

Cadena que se va a escribir. Si value es null, no se escribe nada en la secuencia de texto.

Devoluciones

Task

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

Excepciones

ObjectDisposedException

Se elimina el escritor de texto.

InvalidOperationException

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

Comentarios

La TextWriter clase es una clase abstracta. Por lo tanto, no se crea una instancia en el código. Para obtener un ejemplo del uso del WriteAsync método , vea el StreamWriter.WriteAsync método .

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 Write(String).

Consulte también

• WriteAsync(String)
• WriteAsync(String)

WriteAsync(Char[])

Source:

TextWriter.cs

Escribe una matriz de caracteres en la secuencia de texto de forma asincrónica.

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);

public System.Threading.Tasks.Task WriteAsync(char[]? buffer);

member this.WriteAsync : char[] -> System.Threading.Tasks.Task

Public Function WriteAsync (buffer As Char()) As Task

Parámetros

buffer

Char[]

Matriz de caracteres que se va a escribir en la secuencia de texto. Si buffer es null, no se escribe nada.

Devoluciones

Task

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

Excepciones

ObjectDisposedException

Se elimina el escritor de texto.

InvalidOperationException

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

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 Write(Char[]).

Consulte también

• StreamWriter
• StringWriter