PathIO Clase

Definición

Espacio de nombres:

Windows.Storage

Proporciona métodos auxiliares para leer y escribir un archivo mediante la ruta de acceso absoluta o el identificador uniforme de recursos (URI) del archivo.

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

Herencia

Object Platform::Object IInspectable PathIO

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

Puede usar WriteTextAsync(filePathOrURI, contents) para escribir texto en un archivo. En el ejemplo, filePathOrURI es una variable local que contiene un URI (como un URI de aplicación "ms-appdata://sampleFile.dat") o una ruta de acceso del sistema de archivos (como C:\examplepath\sampleFile.dat) para que el archivo se lea. 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.

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
}

Puede usar ReadTextAsync(filePathOrURI) para leer texto de un archivo. 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.

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

Para obtener más ejemplos relacionados, vea Ejemplo de acceso a archivos y FileIO.

Comentarios

Para leer o escribir en un archivo mediante una ruta de acceso o un identificador uniforme de recursos (URI), debe tener permiso para acceder a la ubicación del archivo. Para obtener más información sobre las ubicaciones a las que la aplicación tiene permiso de acceso, consulte Permisos de acceso a archivos.

Puede especificar un identificador uniforme de recursos (URI) de la aplicación para leer o escribir archivos en ubicaciones específicas de la aplicación, como la carpeta de datos de la aplicación ("ms-appdata://"). Para obtener más información sobre el identificador uniforme de recursos (URI) de la aplicación, consulte Cómo hacer referencia al contenido.

Métodos

AppendLinesAsync(String, IIterable<String>)	Anexa líneas de texto al archivo en la ruta de acceso especificada o identificador uniforme de recursos (URI).
AppendLinesAsync(String, IIterable<String>, UnicodeEncoding)	Anexa líneas de texto al archivo en la ruta de acceso especificada o identificador uniforme de recursos (URI) mediante la codificación de caracteres especificada.
AppendTextAsync(String, String)	Anexa texto al archivo en la ruta de acceso especificada o identificador uniforme de recursos (URI).
AppendTextAsync(String, String, UnicodeEncoding)	Anexa texto al archivo en la ruta de acceso especificada o identificador uniforme de recursos (URI) mediante la codificación de caracteres especificada.
ReadBufferAsync(String)	Lee el contenido del archivo en la ruta de acceso especificada o el identificador uniforme de recursos (URI) y devuelve un búfer.
ReadLinesAsync(String)	Lee el contenido del archivo en la ruta de acceso especificada o el identificador uniforme de recursos (URI) y devuelve líneas de texto.
ReadLinesAsync(String, UnicodeEncoding)	Lee el contenido del archivo en la ruta de acceso especificada o el identificador uniforme de recursos (URI) mediante la codificación de caracteres especificada y devuelve líneas de texto.
ReadTextAsync(String)	Lee el contenido del archivo en la ruta de acceso especificada o el identificador uniforme de recursos (URI) y devuelve texto.
ReadTextAsync(String, UnicodeEncoding)	Lee el contenido del archivo en la ruta de acceso especificada o el identificador uniforme de recursos (URI) utilizando la codificación de caracteres especificada y devuelve texto.
WriteBufferAsync(String, IBuffer)	Escribe datos de un búfer en el archivo en la ruta de acceso especificada o identificador uniforme de recursos (URI).
WriteBytesAsync(String, Byte[])	Escribe un solo byte de datos en el archivo en la ruta de acceso especificada o identificador uniforme de recursos (URI).
WriteLinesAsync(String, IIterable<String>)	Escribe líneas de texto en el archivo en la ruta de acceso especificada o en el identificador uniforme de recursos (URI).
WriteLinesAsync(String, IIterable<String>, UnicodeEncoding)	Escribe líneas de texto en el archivo en la ruta de acceso especificada o identificador uniforme de recursos (URI) mediante la codificación de caracteres especificada.
WriteTextAsync(String, String)	Escribe texto en el archivo en la ruta de acceso especificada o en el identificador uniforme de recursos (URI).
WriteTextAsync(String, String, UnicodeEncoding)	Escribe texto en el archivo en la ruta de acceso especificada o en el identificador uniforme de recursos (URI) mediante la codificación de caracteres especificada.

Consulte también

• FileIO
• Ejemplo de acceso a archivos