File.WriteAllTextAsync 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
WriteAllTextAsync(String, String, CancellationToken)	Cria assíncronamente um novo ficheiro, escreve a string especificada no ficheiro e depois fecha o ficheiro. Se o ficheiro de destino já existir, é truncado e sobrescrevido.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Cria assíncronamente um novo ficheiro, escreve a string especificada no ficheiro usando a codificação especificada e depois fecha o ficheiro. Se o ficheiro de destino já existir, é truncado e sobrescrevido.

WriteAllTextAsync(String, String, CancellationToken)

Cria assíncronamente um novo ficheiro, escreve a string especificada no ficheiro e depois fecha o ficheiro. Se o ficheiro de destino já existir, é truncado e sobrescrevido.

public static System.Threading.Tasks.Task WriteAllTextAsync(string path, string contents, System.Threading.CancellationToken cancellationToken = default);

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

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

Parâmetros

path: String

O ficheiro para escrever.

contents: String

A cadeia a escrever no 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 escrita 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 WriteAllText(String, String).

Aplica-se a

WriteAllTextAsync(String, String, Encoding, CancellationToken)

Cria assíncronamente um novo ficheiro, escreve a string especificada no ficheiro usando a codificação especificada e depois fecha o ficheiro. Se o ficheiro de destino já existir, é truncado e sobrescrevido.

public static System.Threading.Tasks.Task WriteAllTextAsync(string path, string contents, System.Text.Encoding encoding, System.Threading.CancellationToken cancellationToken = default);

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

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