FileIO Classe

Définition

Espace de noms:

Windows.Storage

Fournit des méthodes d’assistance pour la lecture et l’écriture de fichiers représentés par des objets de type IStorageFile.

public ref class FileIO 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 FileIO 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 FileIO

Public Class FileIO

Héritage

Object Platform::Object IInspectable FileIO

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

L’exemple d’accès aux fichiers vous montre comment utiliser WriteTextAsync(fichier, contenu) pour écrire du texte dans un fichier.

try
{
    if (file != null)
    {
        await FileIO.WriteTextAsync(file, "Swift as a shadow");
    }
}
catch (FileNotFoundException)
{
    // For example, handle file not found
}

try
{
    if (file)
    {
        co_await FileIO::WriteTextAsync(file, L"Swift as a shadow");
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

Dans l’exemple, file est une variable locale qui contient un StorageFile qui représente le fichier à écrire.

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. L’exemple d’accès aux fichiers vous montre également comment utiliser ReadTextAsync(file) pour lire du texte à partir d’un fichier.

try
{
    if (file != null)
    {
        string fileContent = await FileIO.ReadTextAsync(file);
    }
}
catch (FileNotFoundException)
{
    // For example, handle file not found
}

try
{
    if (file)
    {
        hstring fileContent = co_await FileIO::ReadTextAsync(file);
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

Dans l’exemple, file est une variable locale qui contient un StorageFile qui représente le fichier à lire.

Une fois ReadTextAsync terminé, la fileContent variable obtient le contenu du fichier sous la forme d’une chaîne de texte. Vous pouvez ensuite traiter le contenu comme il convient.

Remarques

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

Pour en savoir plus sur les emplacements accessibles par votre application, consultez Autorisations d’accès aux fichiers.

Pour savoir comment lire et écrire dans des fichiers, consultez Créer, écrire et lire un fichier.

Méthodes

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