Lire en anglais

Partager via


File.CreateText(String) Méthode

Définition

Crée ou ouvre un fichier pour écrire du texte encodé en UTF-8. Si le fichier existe déjà, son contenu est remplacé.

public static System.IO.StreamWriter CreateText (string path);

Paramètres

path
String

Fichier à ouvrir pour écriture.

Retours

Élément StreamWriter qui écrit dans le fichier spécifié en utilisant l'encodage UTF-8.

Exceptions

L'appelant n'a pas l'autorisation requise.

- ou -

path a spécifié un fichier en lecture seule.

- ou -

path a spécifié un fichier qui est masqué.

.NET Framework et .NET Core versions antérieures à 2.1 : path est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().

path a la valeur null.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

path est dans un format non valide.

Exemples

L’exemple suivant crée un fichier pour l’écriture et la lecture de texte.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }	
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

Remarques

Cette méthode équivaut à la surcharge de StreamWriter(String, Boolean) constructeur avec le append paramètre défini sur false. Si le fichier spécifié par path n’existe pas, il est créé. Si le fichier existe, son contenu est remplacé. Des threads supplémentaires sont autorisés à lire le fichier lorsqu’il est ouvert.

Le path paramètre est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Voir aussi