PathIO Classe

Definição

Namespace:

Windows.Storage

Fornece métodos auxiliares para ler e gravar um arquivo usando o caminho absoluto ou o URI (Uniform Resource Identifier) do arquivo.

public ref class PathIO abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PathIO final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class PathIO

Public Class PathIO

Herança

Object Platform::Object IInspectable PathIO

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Você pode usar WriteTextAsync(filePathOrURI, contents) para gravar texto em um arquivo. No exemplo, filePathOrURI é uma variável local que contém um URI (como um URI de aplicativo "ms-appdata://sampleFile.dat") ou um caminho do sistema de arquivos (como C:\examplepath\sampleFile.dat) para o arquivo ler. Embora os métodos WriteTextAsync não tenham um valor retornado, você ainda poderá executar tarefas adicionais depois que o texto for gravado no arquivo, como mostra o exemplo.

try
{
    if (file != null)
    {
        await PathIO.WriteTextAsync(filePathOrURI, "Swift as a shadow");
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
    // For example, handle file not found
}

Você pode usar ReadTextAsync(filePathOrURI) para ler texto de um arquivo. Após a conclusão de ReadTextAsync , a fileContent variável obtém o conteúdo do arquivo como uma cadeia de caracteres de texto. Em seguida, você pode processar o conteúdo conforme apropriado.

try
{
    if (file != null)
    {
        string fileContent = await PathIO.ReadTextAsync(filePathOrURI);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
    // For example, handle file not found
}

Para obter mais exemplos relacionados, consulte Exemplo de Acesso a Arquivos e FileIO.

Comentários

Para ler ou gravar em um arquivo usando um caminho ou um URI (Uniform Resource Identifier), você deve ter permissão para acessar o local do arquivo. Para saber mais sobre quais locais seu aplicativo tem permissão para acessar, confira Permissões de acesso a arquivos.

Você pode especificar um URI (Uniform Resource Identifier) do aplicativo para ler ou gravar arquivos em locais específicos do aplicativo, como a pasta de dados do aplicativo ("ms-appdata://"). Para saber mais sobre o URI (Uniform Resource Identifier) do aplicativo, consulte Como fazer referência ao conteúdo.

Métodos

AppendLinesAsync(String, IIterable<String>)	Acrescenta linhas de texto ao arquivo no caminho especificado ou no URI (Uniform Resource Identifier).
AppendLinesAsync(String, IIterable<String>, UnicodeEncoding)	Acrescenta linhas de texto ao arquivo no caminho especificado ou no URI (Uniform Resource Identifier) usando a codificação de caractere especificada.
AppendTextAsync(String, String)	Acrescenta o texto ao arquivo no caminho especificado ou no URI (Uniform Resource Identifier).
AppendTextAsync(String, String, UnicodeEncoding)	Acrescenta o texto ao arquivo no caminho especificado ou no URI (Uniform Resource Identifier) usando a codificação de caractere especificada.
ReadBufferAsync(String)	Lê o conteúdo do arquivo no caminho especificado ou no URI (Uniform Resource Identifier) e retorna um buffer.
ReadLinesAsync(String)	Lê o conteúdo do arquivo no caminho especificado ou no URI (Uniform Resource Identifier) e retorna linhas de texto.
ReadLinesAsync(String, UnicodeEncoding)	Lê o conteúdo do arquivo no caminho especificado ou no URI (Uniform Resource Identifier) usando a codificação de caractere especificada e retorna linhas de texto.
ReadTextAsync(String)	Lê o conteúdo do arquivo no caminho especificado ou no URI (Uniform Resource Identifier) e retorna texto.
ReadTextAsync(String, UnicodeEncoding)	Lê o conteúdo do arquivo no caminho especificado ou no URI (Uniform Resource Identifier) usando a codificação de caractere especificada e retorna o texto.
WriteBufferAsync(String, IBuffer)	Grava dados de um buffer no arquivo no caminho especificado ou no URI (Uniform Resource Identifier).
WriteBytesAsync(String, Byte[])	Grava um único byte de dados no arquivo no caminho especificado ou no URI (Uniform Resource Identifier).
WriteLinesAsync(String, IIterable<String>)	Grava linhas de texto no arquivo no caminho especificado ou no URI (Uniform Resource Identifier).
WriteLinesAsync(String, IIterable<String>, UnicodeEncoding)	Grava linhas de texto no arquivo no caminho especificado ou no URI (Uniform Resource Identifier) usando a codificação de caractere especificada.
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 caractere especificada.

Confira também

• FileIO
• Exemplo de Acesso a Arquivos