Windows Dev Center

PathIO Class

Fournit des méthodes d'assistance pour la lecture et l'écriture d'un fichier à l'aide du chemin d'accès absolu ou de l'URI du fichier.

Syntaxe


var pathIO = Windows.Storage.PathIO;

Attributs

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

Membres

PathIOClasse comporte les types de membres suivants :

Méthodes

The PathIO Classe comporte les méthodes suivantes. Avec C#, Visual Basic et C++, il hérite également des méthodes de Object Classe.

MéthodeDescription
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.

 

Remarques

Cette classe est statique et ne peut pas être instanciée. À la place, appelle les méthodes directement.

Remarque  Pour lire ou écrire dans un fichier à l'aide d'un chemin ou des URI, vous devez avoir l'autorisation d'accéder à l'emplacement du fichier. Pour en savoir plus sur les emplacements auxquels votre application a l'autorisation d'accéder, consultez la section relative à l'accès à un fichier et les autorisations dans les applications Windows Store.

Vous pouvez spécifier les URI d'application pour lire ou écrire des fichiers spécifiques à l'application comme votre dossier de données d'application ("ms-appdata://"). Pour en savoir plus sur les URI d'application, consultez Comment référencer le contenu.

Exemples

Vous pouvez utiliser writeTextAsync(filePathOrURI, contents) pour écrire dans un fichier, comme suit :



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

Dans l'exemple, filePathOrURI est une variable locale qui contient un URI (par exemple, un URI d'application "ms-appdata://sampleFile.dat") ou un chemin d'accès au système de fichiers (par exemple, C:\examplepath\sampleFile.dat) pour le fichier à lire.

Bien que les méthodes writeTextAsync n'aient pas de valeur de retour, vous pouvez toujours effectuer des tâches supplémentaires une fois le texte écrit dans le fichier, comme le montre l'exemple.

Vous pouvez utiliser readTextAsync(filePathOrURI) pour lire le texte d'un fichier, comme ceci :


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

Dans l'exemple, filePathOrURI est une variable locale qui contient un URI (par exemple, un URI d'application "ms-appdata://sampleFile.dat") ou un chemin d'accès au système de fichiers (par exemple, C:\examplepath\sampleFile.dat) pour le fichier à lire.

Une fois readTextAsync terminée, la variable fileContent obtient le contenu du fichier sous la forme d'une chaîne de texte. Vous pouvez ensuite traiter le contenu, selon le cas.

Pour consulter d'autres exemples connexes, reportez-vous à Exemple d'accès au fichier et FileIO.

Configuration requise

Client minimal pris en charge

Windows 8 [Applications du Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store uniquement]

Espace de noms

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

Métadonnées

Windows.winmd

Voir aussi

Exemple d'accès au fichier
FileIO

 

 

Afficher:
© 2015 Microsoft