PathIO Class

Fornisce metodi helper per la lettura e la scrittura di un file utilizzando il percorso assoluto o l'URI del file.

Sintassi


var pathIO = Windows.Storage.PathIO;

Attributi

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

Membri

Il PathIOClasse dispone di questi tipi di membri:

Metodi

The PathIO Classe dispone di questi metodi. Con C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

MetodoDescrizione
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.

 

Osservazioni

Questa classe è statica e non è possibile quindi crearne un'istanza. Chiamare invece i metodi direttamente.

Nota  Per leggere o scrivere in un file utilizzando un percorso o gli URI, è necessario disporre delle autorizzazioni di accesso al percorso del file. Per ulteriori informazioni sui i percorsi per cui l'applicazione dispone dell'autorizzazione di accesso, vedere Accesso ai file e autorizzazioni nelle app di Windows Store.

È possibile specificare gli URI di un'applicazione per leggere o scrivere nei file nei percorsi specifici dell'applicazione come la cartella dei dati dell'applicazione ("ms-appdata://"). Per ulteriori informazioni sugli URI di applicazione, vedere Come fare riferimento al contenuto.

Esempi

È possibile utilizzare l'oggetto writeTextAsync(filePathOrURI, contents) per scrivere un testo in un file come riportato di seguito:



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

Nell'esempio filePathOrURI è una variabile locale contenente un URI, ad esempio l'URI "ms-appdata://sampleFile.dat" di un'applicazione, o un percorso del file system, ad esempio C:\examplepath\sampleFile.dat, del file da leggere.

Sebbene i metodi writeTextAsync non abbiano un valore restituito, è comunque possibile eseguire attività aggiuntive dopo la scrittura del testo nel file, come illustrato nell'esempio.

È possibile utilizzare readTextAsync(filePathOrURI) per leggere il testo da un file, come illustrato di seguito:


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

Nell'esempio filePathOrURI è una variabile locale contenente un URI, ad esempio l'URI "ms-appdata://sampleFile.dat" di un'applicazione, o un percorso del file system, ad esempio C:\examplepath\sampleFile.dat, del file da leggere.

Dopo il completamento di readTextAsync, la variabile fileContent ottiene il contenuto del file come stringa di testo. È quindi possibile elaborare il contenuto in base alle proprie esigenze.

Per ulteriori esempi correlati, vedere Esempio di accesso ai file e FileIO.

Requisiti

Client minimo supportato

Windows 8 [solo app di Windows Store]

Server minimo supportato

Windows Server 2012 [solo app di Windows Store]

Spazio dei nomi

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

Metadati

Windows.winmd

Vedi anche

Esempio di accesso ai file
FileIO

 

 

Mostra:
© 2014 Microsoft