File.AppendAllTextAsync Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Sobrecargas

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)	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, String, CancellationToken)

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);

static member AppendAllTextAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function AppendAllTextAsync (path As String, contents As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Pará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 para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

Tarea que representa la operación de anexar de forma 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, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por AppendAllText(String, String).

AppendAllTextAsync(String, String, Encoding, CancellationToken)

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);

static member AppendAllTextAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function AppendAllTextAsync (path As String, contents As String, encoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Pará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 utilizará.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

Tarea que representa la operación de anexar de forma 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, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por AppendAllText(String, String, Encoding).