FileIO Classe

Definição

Namespace:

Windows.Storage

Fornece métodos auxiliares para ler e gravar arquivos que são representados por objetos do tipo IStorageFile.

public ref class FileIO 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 FileIO 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 FileIO

Public Class FileIO

Herança

Object Platform::Object IInspectable FileIO

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

O exemplo de Acesso a Arquivos mostra como usar WriteTextAsync (arquivo, conteúdo) para gravar texto em um arquivo.

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

try
{
    if (file)
    {
        co_await FileIO::WriteTextAsync(file, L"Swift as a shadow");
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

No exemplo, file é uma variável local que contém um StorageFile que representa o arquivo a ser gravado.

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. O exemplo de Acesso a Arquivos também mostra como usar ReadTextAsync(file) para ler texto de um arquivo.

try
{
    if (file != null)
    {
        string fileContent = await FileIO.ReadTextAsync(file);
    }
}
catch (FileNotFoundException)
{
    // For example, handle file not found
}

try
{
    if (file)
    {
        hstring fileContent = co_await FileIO::ReadTextAsync(file);
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

No exemplo, file é uma variável local que contém um StorageFile que representa o arquivo a ser lido.

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.

Comentários

Essa classe é estática e não pode ser instanciada. Em vez disso, chame os métodos diretamente.

Para saber mais sobre quais locais seu aplicativo pode acessar, consulte Permissões de acesso a arquivos.

Para saber como ler e gravar em arquivos, confira Criar, gravar e ler um arquivo.

Métodos

AppendLinesAsync(IStorageFile, IIterable<String>)	Acrescenta linhas de texto ao arquivo especificado.
AppendLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Acrescenta linhas de texto ao arquivo especificado usando a codificação de caracteres especificada.
AppendTextAsync(IStorageFile, String)	Acrescenta texto ao arquivo especificado.
AppendTextAsync(IStorageFile, String, UnicodeEncoding)	Acrescenta texto ao arquivo especificado usando a codificação de caracteres especificada.
ReadBufferAsync(IStorageFile)	Lê o conteúdo do arquivo especificado e retorna um buffer.
ReadLinesAsync(IStorageFile)	Lê o conteúdo do arquivo especificado e retorna linhas de texto.
ReadLinesAsync(IStorageFile, UnicodeEncoding)	Lê o conteúdo do arquivo especificado usando a codificação de caracteres especificada e retorna linhas de texto.
ReadTextAsync(IStorageFile)	Lê o conteúdo do arquivo especificado e retorna texto.
ReadTextAsync(IStorageFile, UnicodeEncoding)	Lê o conteúdo do arquivo especificado usando a codificação de caracteres especificada e retorna texto.
WriteBufferAsync(IStorageFile, IBuffer)	Grava dados de um buffer no arquivo especificado.
WriteBytesAsync(IStorageFile, Byte[])	Grava uma matriz de bytes de dados no arquivo especificado.
WriteLinesAsync(IStorageFile, IIterable<String>)	Grava linhas de texto no arquivo especificado.
WriteLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Grava linhas de texto no arquivo especificado usando a codificação de caracteres especificada.
WriteTextAsync(IStorageFile, String)	Grava texto no arquivo especificado.
WriteTextAsync(IStorageFile, String, UnicodeEncoding)	Grava texto no arquivo especificado usando a codificação de caracteres especificada.