PathIO Class

Proporciona métodos auxiliares para leer y escribir archivos mediante la ruta de acceso absoluta o URI del archivo.

Sintaxis


var pathIO = Windows.Storage.PathIO;

Atributos

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Miembros

PathIOClase tiene estos tipos de miembros:

Métodos

The PathIO Clase tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

MétodoDescripción
AppendLinesAsync(String, IIterable(String)) Appends lines of text to the file at the specified path or Uniform Resource Identifier (URI).
AppendLinesAsync(String, IIterable(String), UnicodeEncoding) Appends lines of text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
AppendTextAsync(String, String) Appends text to the file at the specified path or Uniform Resource Identifier (URI).
AppendTextAsync(String, String, UnicodeEncoding) Appends text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
ReadBufferAsync Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns a buffer.
ReadLinesAsync(String) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns lines of text.
ReadLinesAsync(String, UnicodeEncoding) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding and returns lines of text.
ReadTextAsync(String) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns text.
ReadTextAsync(String, UnicodeEncoding) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding and returns text.
WriteBufferAsync Writes data from a buffer to the file at the specified path or Uniform Resource Identifier (URI).
WriteBytesAsync Writes a single byte of data to the file at the specified path or Uniform Resource Identifier (URI).
WriteLinesAsync(String, IIterable(String)) Writes lines of text to the file at the specified path or Uniform Resource Identifier (URI).
WriteLinesAsync(String, IIterable(String), UnicodeEncoding) Writes lines of text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
WriteTextAsync(String, String) Writes text to the file at the specified path or Uniform Resource Identifier (URI).
WriteTextAsync(String, String, UnicodeEncoding) Writes text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.

 

Observaciones

Esta clase es estática y no se pueden crear instancias de la misma. Llame a los métodos directamente en su lugar.

Nota  Para leer o escribir en un archivo mediante una ruta de acceso o los URI, debe tener permiso de acceso a la ubicación del archivo. Para obtener más información sobre a qué ubicaciones la aplicación tiene permiso de acceso, vea el tema acceso a archivos y permisos en aplicaciones de la Tienda Windows.

Puede especificar los URI de una 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 los URI de aplicación, vea el tema sobre cómo hacer referencia a un contenido.

Ejemplos

Puede usar writeTextAsync(filePathOrURI, contents) para escribir texto en un archivo, de esta forma:



if (file !== null) {
    Windows.Storage.PathIO.writeTextAsync(filePathOrURI, "Swift as a shadow").done(function () {
        // Perform additional tasks after file is written
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during write
    });
}

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 al sistema de archivos (como C:\examplepath\sampleFile.dat) para el archivo que se va a leer.

Aunque los métodos de writeTextAsync no tienen un valor devuelto, todavía puede realizar tareas adicionales después de que el texto se escriba en el archivo, como se muestra en el ejemplo.

Puede utilizar readTextAsync(filePathOrURI) para leer texto de un archivo, como se indica a continuación:


if (file !== null) {
    Windows.Storage.PathIO.readTextAsync(filePathOrURI).done(function (fileContent) {
        // Process content read from the file
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during read
    });
}

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 al sistema de archivos (como C:\examplepath\sampleFile.dat) para el archivo que se va a leer.

Después de que readTextAsync se complete, la variable fileContent obtiene el contenido del archivo como una cadena de texto. Puede procesar el contenido según corresponda.

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

Requisitos

Cliente mínimo compatible

Windows 8 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo compatible

Windows Server 2012 [Solo aplicaciones de la Tienda Windows]

Espacio de nombres

Windows.Storage
Windows::Storage [C++]

Metadatos

Windows.winmd

Consulta también

Ejemplo de acceso a archivos
FileIO

 

 

Mostrar:
© 2015 Microsoft