File.AppendAllLinesAsync Método

Definição

Espaço de Nomes:: System.IO

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Adiciona linhas assíncronas a um ficheiro e depois fecha o ficheiro. Se o ficheiro especificado não existir, este método cria um ficheiro, escreve as linhas especificadas no ficheiro e depois fecha o ficheiro.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Adiciona linhas assíncronas a um ficheiro usando uma codificação especificada, e depois fecha o ficheiro. Se o ficheiro especificado não existir, este método cria um ficheiro, escreve as linhas especificadas no ficheiro e depois fecha o ficheiro.

AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)

Adiciona linhas assíncronas a um ficheiro e depois fecha o ficheiro. Se o ficheiro especificado não existir, este método cria um ficheiro, escreve as linhas especificadas no ficheiro e depois fecha o ficheiro.

public static System.Threading.Tasks.Task AppendAllLinesAsync(string path, System.Collections.Generic.IEnumerable<string> contents, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllLinesAsync : string * seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

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

Parâmetros

path: String

O ficheiro para anexar as linhas. O ficheiro é criado se ainda não existir.

contents: IEnumerable<String>

As linhas a anexar ao ficheiro.

cancellationToken: CancellationToken

O token para monitorizar pedidos de cancelamento. O valor predefinido é None.

Devoluções

Task

Uma tarefa que representa a operação de anexação assíncrona.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por AppendAllLines(String, IEnumerable<String>).

Aplica-se a

AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)

Adiciona linhas assíncronas a um ficheiro usando uma codificação especificada, e depois fecha o ficheiro. Se o ficheiro especificado não existir, este método cria um ficheiro, escreve as linhas especificadas no ficheiro e depois fecha o ficheiro.

public static System.Threading.Tasks.Task AppendAllLinesAsync(string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

static member AppendAllLinesAsync : string * seq<string> * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

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