FileIO Clase

Definición

Espacio de nombres:

Windows.Storage

Proporciona métodos auxiliares para leer y escribir archivos representados por objetos de 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

Herencia

Object Platform::Object IInspectable FileIO

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

El ejemplo de acceso a archivos muestra cómo usar WriteTextAsync(file, contents) para escribir texto en un archivo.

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
    }
}

En el ejemplo, file es una variable local que contiene un storageFile que representa el archivo que se va a escribir.

Aunque los métodos WriteTextAsync no tienen un valor devuelto, todavía puede realizar tareas adicionales después de escribir el texto en el archivo, como se muestra en el ejemplo. El ejemplo de acceso a archivos también muestra cómo usar ReadTextAsync(file) para leer texto de un archivo.

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
    }
}

En el ejemplo, file es una variable local que contiene un storageFile que representa el archivo que se va a leer.

Una vez completado ReadTextAsync , la fileContent variable obtiene el contenido del archivo como una cadena de texto. A continuación, puede procesar el contenido según corresponda.

Comentarios

Esta clase es estática y no se puede crear una instancia de ella. Llame directamente a los métodos.

Para obtener más información sobre las ubicaciones a las que puede acceder la aplicación, consulta Permisos de acceso a archivos.

Para aprender a leer y escribir en archivos, consulte Creación, escritura y lectura de un archivo.

Métodos

AppendLinesAsync(IStorageFile, IIterable<String>)	Anexa líneas de texto al archivo especificado.
AppendLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Anexa líneas de texto al archivo especificado utilizando la codificación de caracteres especificada.
AppendTextAsync(IStorageFile, String)	Anexa texto al archivo especificado.
AppendTextAsync(IStorageFile, String, UnicodeEncoding)	Anexa texto al archivo especificado utilizando la codificación de caracteres especificada.
ReadBufferAsync(IStorageFile)	Lee el contenido del archivo especificado y devuelve un búfer.
ReadLinesAsync(IStorageFile)	Lee el contenido del archivo especificado y devuelve líneas de texto.
ReadLinesAsync(IStorageFile, UnicodeEncoding)	Lee el contenido del archivo especificado utilizando la codificación de caracteres especificada y devuelve líneas de texto.
ReadTextAsync(IStorageFile)	Lee el contenido del archivo especificado y devuelve texto.
ReadTextAsync(IStorageFile, UnicodeEncoding)	Lee el contenido del archivo especificado utilizando la codificación de caracteres especificada y devuelve texto.
WriteBufferAsync(IStorageFile, IBuffer)	Escribe datos de un búfer en el archivo especificado.
WriteBytesAsync(IStorageFile, Byte[])	Escribe una matriz de bytes de datos en el archivo especificado.
WriteLinesAsync(IStorageFile, IIterable<String>)	Escribe líneas de texto en el archivo especificado.
WriteLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Escribe líneas de texto en el archivo especificado utilizando la codificación de caracteres especificada.
WriteTextAsync(IStorageFile, String)	Escribe texto en el archivo especificado.
WriteTextAsync(IStorageFile, String, UnicodeEncoding)	Escribe texto en el archivo especificado utilizando la codificación de caracteres especificada.