Compartilhar via


FileIO Classe

Definição

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

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.

Aplica-se a