PathIO Classe

Définition

Espace de noms:

Windows.Storage

Fournit des méthodes d’assistance pour lire et écrire un fichier à l’aide du chemin absolu ou de l’URI (Uniform Resource Identifier) du fichier.

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

Héritage

Object Platform::Object IInspectable PathIO

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Vous pouvez utiliser WriteTextAsync(filePathOrURI, contents) pour écrire du texte dans un fichier. Dans l’exemple, filePathOrURI est une variable locale qui contient un URI (comme un URI d’application « ms-appdata://sampleFile.dat ») ou un chemin du système de fichiers (comme C:\examplepath\sampleFile.dat) que le fichier doit lire. Bien que les méthodes WriteTextAsync n’aient pas de valeur de retour, vous pouvez toujours effectuer des tâches supplémentaires après l’écriture du texte dans le fichier, comme le montre l’exemple.

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
}

Vous pouvez utiliser ReadTextAsync(filePathOrURI) pour lire le texte d’un fichier. Une fois ReadTextAsync terminé, la fileContent variable obtient le contenu du fichier sous forme de chaîne de texte. Vous pouvez ensuite traiter le contenu selon les besoins.

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

Pour plus d’exemples connexes, consultez Exemple d’accès aux fichiers et FileIO.

Remarques

Pour lire ou écrire dans un fichier à l’aide d’un chemin d’accès ou d’un URI (Uniform Resource Identifier), vous devez être autorisé à accéder à l’emplacement du fichier. Pour en savoir plus sur les emplacements d’accès de votre application, consultez Autorisations d’accès aux fichiers.

Vous pouvez spécifier un URI (Uniform Resource Identifier) d’application pour lire ou écrire des fichiers dans des emplacements spécifiques à l’application, comme votre dossier de données d’application (« ms-appdata:// »). Pour en savoir plus sur l’URI (Uniform Resource Identifier) d’application, consultez Guide pratique pour référencer du contenu.

Méthodes

AppendLinesAsync(String, IIterable<String>)	Ajoute des lignes de texte au fichier au niveau du chemin d’accès spécifié ou de l’URI (Uniform Resource Identifier).
AppendLinesAsync(String, IIterable<String>, UnicodeEncoding)	Ajoute des lignes de texte au fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié à l’aide de l’encodage de caractères spécifié.
AppendTextAsync(String, String)	Ajoute du texte au fichier au niveau du chemin d’accès spécifié ou de l’URI (Uniform Resource Identifier).
AppendTextAsync(String, String, UnicodeEncoding)	Ajoute du texte au fichier au niveau du chemin d’accès spécifié ou de l’URI (Uniform Resource Identifier) à l’aide de l’encodage de caractères spécifié.
ReadBufferAsync(String)	Lit le contenu du fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié et retourne une mémoire tampon.
ReadLinesAsync(String)	Lit le contenu du fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié et retourne des lignes de texte.
ReadLinesAsync(String, UnicodeEncoding)	Lit le contenu du fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié à l’aide de l’encodage de caractères spécifié et retourne des lignes de texte.
ReadTextAsync(String)	Lit le contenu du fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié et retourne le texte.
ReadTextAsync(String, UnicodeEncoding)	Lit le contenu du fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié à l’aide de l’encodage de caractères spécifié et retourne du texte.
WriteBufferAsync(String, IBuffer)	Écrit les données d’une mémoire tampon dans le fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié.
WriteBytesAsync(String, Byte[])	Écrit un seul octet de données dans le fichier au niveau du chemin d’accès ou de l’URI (Uniform Resource Identifier) spécifié.
WriteLinesAsync(String, IIterable<String>)	Écrit des lignes de texte dans le fichier au niveau du chemin d’accès spécifié ou de l’URI (Uniform Resource Identifier).
WriteLinesAsync(String, IIterable<String>, UnicodeEncoding)	Écrit des lignes de texte dans le fichier au niveau du chemin d’accès spécifié ou de l’URI (Uniform Resource Identifier) à l’aide de l’encodage de caractères spécifié.
WriteTextAsync(String, String)	Écrit le texte dans le fichier au niveau du chemin d’accès spécifié ou de l’URI (Uniform Resource Identifier).
WriteTextAsync(String, String, UnicodeEncoding)	Écrit du texte dans le fichier au niveau du chemin d’accès spécifié ou de l’URI (Uniform Resource Identifier) à l’aide de l’encodage de caractères spécifié.

Voir aussi

• FileIO
• Exemple d’accès aux fichiers