File.AppendAllTextAsync 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í.
Sobrecargas
| AppendAllTextAsync(String, String, Encoding, CancellationToken) |
Abre de forma asincrónica un archivo o crea el archivo si aún no existe, anexa la cadena especificada al archivo mediante la codificación especificada y, a continuación, cierra el archivo. |
| AppendAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken) |
Abre de forma asincrónica un archivo o crea el archivo si aún no existe, anexa la cadena especificada al archivo mediante la codificación especificada y, a continuación, cierra el archivo. |
| AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken) |
Abre de forma asincrónica un archivo o crea un archivo si aún no existe, anexa la cadena especificada al archivo y, a continuación, cierra el archivo. |
| AppendAllTextAsync(String, String, CancellationToken) |
Abre de forma asincrónica un archivo o crea un archivo si aún no existe, anexa la cadena especificada al archivo y, a continuación, cierra el archivo. |
AppendAllTextAsync(String, String, Encoding, CancellationToken)
- Source:
- File.cs
- Source:
- File.cs
- Source:
- File.cs
Abre de forma asincrónica un archivo o crea el archivo si aún no existe, anexa la cadena especificada al archivo mediante la codificación especificada y, a continuación, cierra el archivo.
public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);static member AppendAllTextAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function AppendAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- path
- String
Archivo al que se va a anexar la cadena especificada.
- contents
- String
Cadena que se va a anexar al archivo.
- encoding
- Encoding
Codificación de caracteres que se va a usar.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Tarea que representa la operación de anexión asincrónica.
Excepciones
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 AppendAllText(String, String, Encoding).
Se aplica a
AppendAllTextAsync(String, ReadOnlyMemory<Char>, Encoding, CancellationToken)
Abre de forma asincrónica un archivo o crea el archivo si aún no existe, anexa la cadena especificada al archivo mediante la codificación especificada y, a continuación, cierra el archivo.
public static System.Threading.Tasks.Task AppendAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);static member AppendAllTextAsync : string * ReadOnlyMemory<char> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function AppendAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- path
- String
Archivo al que se va a anexar la cadena especificada.
- contents
- ReadOnlyMemory<Char>
Caracteres que se van a anexar al archivo.
- encoding
- Encoding
Codificación de caracteres que se va a usar.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Tarea que representa la operación de anexión asincrónica.
Excepciones
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Se aplica a
AppendAllTextAsync(String, ReadOnlyMemory<Char>, CancellationToken)
Abre de forma asincrónica un archivo o crea un archivo si aún no existe, anexa la cadena especificada al archivo y, a continuación, cierra el archivo.
public static System.Threading.Tasks.Task AppendAllTextAsync (string path, ReadOnlyMemory<char> contents, System.Threading.CancellationToken cancellationToken = default);static member AppendAllTextAsync : string * ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function AppendAllTextAsync (path As String, contents As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- path
- String
Archivo al que se va a anexar la cadena especificada.
- contents
- ReadOnlyMemory<Char>
Caracteres que se van a anexar al archivo.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Tarea que representa la operación de anexión asincrónica.
Excepciones
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Se aplica a
AppendAllTextAsync(String, String, CancellationToken)
- Source:
- File.cs
- Source:
- File.cs
- Source:
- File.cs
Abre de forma asincrónica un archivo o crea un archivo si aún no existe, anexa la cadena especificada al archivo y, a continuación, cierra el archivo.
public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string? contents, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task AppendAllTextAsync (string path, string contents, System.Threading.CancellationToken cancellationToken = default);static member AppendAllTextAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function AppendAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParámetros
- path
- String
Archivo al que se va a anexar la cadena especificada.
- contents
- String
Cadena que se va a anexar al archivo.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Tarea que representa la operación de anexión asincrónica.
Excepciones
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 AppendAllText(String, String).
