Partilhar via


PathIO.WriteTextAsync Método

Definição

Sobrecargas

WriteTextAsync(String, String)

Grava texto no arquivo no caminho especificado ou no URI (Uniform Resource Identifier).

WriteTextAsync(String, String, UnicodeEncoding)

Grava texto no arquivo no caminho especificado ou no URI (Uniform Resource Identifier) usando a codificação de caracteres especificada.

WriteTextAsync(String, String)

Grava texto no arquivo no caminho especificado ou no URI (Uniform Resource Identifier).

public:
 static IAsyncAction ^ WriteTextAsync(Platform::String ^ absolutePath, Platform::String ^ contents);
/// [Windows.Foundation.Metadata.Overload("WriteTextAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncAction WriteTextAsync(winrt::hstring const& absolutePath, winrt::hstring const& contents);
[Windows.Foundation.Metadata.Overload("WriteTextAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncAction WriteTextAsync(string absolutePath, string contents);
function writeTextAsync(absolutePath, contents)
Public Shared Function WriteTextAsync (absolutePath As String, contents As String) As IAsyncAction

Parâmetros

absolutePath
String

Platform::String

winrt::hstring

O caminho do arquivo no qual o texto é gravado.

contents
String

Platform::String

winrt::hstring

O texto a gravação.

Retornos

Nenhum objeto ou valor é retornado quando esse método é concluído.

Atributos

Exemplos

Este exemplo mostra como usar [writeTextAsync(absolutePath, contents) para gravar algum texto arbitrário em um arquivo no caminho no absoluteFilePath, desta forma:

Windows.Storage.FileIO.writeTextAsync(absoluteFilePath, "Swift as a shadow").then(function () {
    // Add code to do something after the text is written to the file
});

Embora os métodos writeTextAsync não tenham um valor retornado, você ainda pode usar oufazer isso para declarar uma função e executar tarefas adicionais depois que o texto for gravado no arquivo, como mostra o exemplo.

Comentários

Esse método tenta detectar automaticamente a codificação de um arquivo com base na presença de marcas de ordem de bytes. Se uma codificação não puder ser detectada, a codificação especificada pelo chamador na sobrecarga do método será usada.

Confira também

Aplica-se a

WriteTextAsync(String, String, UnicodeEncoding)

Grava texto no arquivo no caminho especificado ou no URI (Uniform Resource Identifier) usando a codificação de caracteres especificada.

public:
 static IAsyncAction ^ WriteTextAsync(Platform::String ^ absolutePath, Platform::String ^ contents, UnicodeEncoding encoding);
/// [Windows.Foundation.Metadata.Overload("WriteTextWithEncodingAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncAction WriteTextAsync(winrt::hstring const& absolutePath, winrt::hstring const& contents, UnicodeEncoding const& encoding);
[Windows.Foundation.Metadata.Overload("WriteTextWithEncodingAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncAction WriteTextAsync(string absolutePath, string contents, UnicodeEncoding encoding);
function writeTextAsync(absolutePath, contents, encoding)
Public Shared Function WriteTextAsync (absolutePath As String, contents As String, encoding As UnicodeEncoding) As IAsyncAction

Parâmetros

absolutePath
String

Platform::String

winrt::hstring

O caminho do arquivo no qual o texto é gravado.

contents
String

Platform::String

winrt::hstring

O texto a gravação.

encoding
UnicodeEncoding

A codificação de caracteres do arquivo.

Retornos

Nenhum objeto ou valor é retornado quando esse método é concluído.

Atributos

Confira também

Aplica-se a