TextWriter.WriteAsync Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Escribe datos en la secuencia de texto de forma asincrónica.

Sobrecargas

WriteAsync(Char[], Int32, Int32)	Escribe una submatriz de caracteres en la secuencia de texto de forma asincrónica.
WriteAsync(StringBuilder, CancellationToken)	Escribe un generador de cadenas en la secuencia de texto de forma asincrónica.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Escribe una región de la memoria de caracteres 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)	Escribe un carácter en la secuencia de texto de forma asincrónica.

WriteAsync(Char[], Int32, Int32)

Source:

TextWriter.cs

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

index

Int32

Posición del carácter en el búfer donde comenzar la recuperación de 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

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 texto.

InvalidOperationException

El sistema de escritura de texto está actualmente en uso por una operación de escritura anterior.

Comentarios

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

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

Consulte también

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

WriteAsync(StringBuilder, CancellationToken)

Source:

TextWriter.cs

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

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, que se va a escribir en la secuencia de texto.

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

Sin embargo, este método equivale a llamar WriteAsync(stringBuilder.ToString())a , pero usa el StringBuilder.GetChunks() método para evitar la creación de la cadena intermedia.

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Source:

TextWriter.cs

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

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 la memoria de caracteres que se va a escribir en la secuencia de texto.

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.

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 escribirá nada en la secuencia de texto.

Devoluciones

Task

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

Excepciones

ObjectDisposedException

Se desecha el sistema de escritura de texto.

InvalidOperationException

El sistema de escritura de texto está actualmente en uso por una operación de escritura anterior.

Comentarios

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

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 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 desecha el sistema de escritura de texto.

InvalidOperationException

El sistema de escritura de texto está actualmente en uso por una operación de escritura anterior.

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

Consulte también

• StreamWriter
• StringWriter

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 desecha el sistema de escritura de texto.

InvalidOperationException

El sistema de escritura de texto está actualmente en uso por una operación de escritura anterior.

Comentarios

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

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

Consulte también

• WriteAsync(Char)
• WriteAsync(Char)