TextWriter.WriteAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- TextWriter.cs
- 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);[System.Runtime.InteropServices.ComVisible(false)]
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[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.TaskPublic Overridable Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As TaskPará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
Tarea que representa la operación de escritura asincrónica.
- Atributos
Excepciones
buffer es null.
index más count es mayor que la longitud del búfer.
index o count es negativo.
Se desecha el sistema de escritura de texto.
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
Se aplica a
WriteAsync(StringBuilder, CancellationToken)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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.TaskPublic Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As TaskPará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
Tarea que representa la operación de escritura asincrónica.
Excepciones
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).
Se aplica a
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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.TaskPublic Overridable Function WriteAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As TaskPará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
Tarea que representa la operación de escritura asincrónica.
Excepciones
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Se aplica a
WriteAsync(String)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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);public virtual System.Threading.Tasks.Task WriteAsync (string? value);[System.Runtime.InteropServices.ComVisible(false)]
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[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.TaskPublic Overridable Function WriteAsync (value As String) As TaskParámetros
- value
- String
Cadena que se va a escribir. Si value es null, no se escribirá nada en la secuencia de texto.
Devoluciones
Tarea que representa la operación de escritura asincrónica.
- Atributos
Excepciones
Se desecha el sistema de escritura de texto.
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
Se aplica a
WriteAsync(Char[])
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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);public System.Threading.Tasks.Task WriteAsync (char[]? buffer);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteAsync (char[] buffer);member this.WriteAsync : char[] -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
member this.WriteAsync : char[] -> System.Threading.Tasks.TaskPublic Function WriteAsync (buffer As Char()) As TaskPará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
Tarea que representa la operación de escritura asincrónica.
- Atributos
Excepciones
Se desecha el sistema de escritura de texto.
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
Se aplica a
WriteAsync(Char)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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);[System.Runtime.InteropServices.ComVisible(false)]
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[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.TaskPublic Overridable Function WriteAsync (value As Char) As TaskParámetros
- value
- Char
Carácter que se va a escribir en la secuencia de texto.
Devoluciones
Tarea que representa la operación de escritura asincrónica.
- Atributos
Excepciones
Se desecha el sistema de escritura de texto.
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).
