Partager via


FileSystem.WriteAllText Méthode

Définition

Écrit du texte dans un fichier.

Surcharges

WriteAllText(String, String, Boolean)

Écrit du texte dans un fichier.

WriteAllText(String, String, Boolean, Encoding)

Écrit du texte dans un fichier.

WriteAllText(String, String, Boolean)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Écrit du texte dans un fichier.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public static void WriteAllText (string file, string text, bool append);
static member WriteAllText : string * string * bool -> unit
Public Shared Sub WriteAllText (file As String, text As String, append As Boolean)

Paramètres

file
String

Fichier dans lequel écrire.

text
String

Texte à écrire dans le fichier.

append
Boolean

True pour ajouter au contenu du fichier ; False pour remplacer le contenu du fichier.

Exceptions

Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\) ; il se termine par une barre oblique de fin.

file a la valeur Nothing.

Le fichier n'existe pas.

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

Le chemin d'accès dépasse la longueur maximale définie par le système.

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

Il n'y a pas assez de mémoire pour écrire la chaîne dans la mémoire tampon.

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple écrit la ligne "This is new text to be added." dans le fichier Test.txt, en remplaçant tout texte existant dans le fichier.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

Cet exemple écrit les noms des fichiers dans le Documents and Settings dossier FileList.txtdans , en insérant un retour chariot entre chacun d’eux pour une meilleure lisibilité.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Remarques

L’encodage UTF-8 est utilisé pour écrire dans le fichier. Pour spécifier un autre encodage, utilisez une surcharge différente de la WriteAllText méthode.

Si le fichier spécifié n’existe pas, il est créé.

Si l’encodage spécifié ne correspond pas à l’encodage existant du fichier, le codage spécifié est ignoré.

Notes

La WriteAllText méthode ouvre un fichier, y écrit, puis le ferme. Le code qui utilise la WriteAllText méthode est plus simple que le code qui utilise un StreamWriter objet. Toutefois, si vous ajoutez des chaînes à un fichier à l’aide d’une boucle, un StreamWriter objet peut fournir de meilleures performances, car vous n’avez qu’à ouvrir et fermer le fichier une seule fois. Pour plus d'informations, voir la méthode OpenTextFileWriter.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.WriteAllText méthode.

À Consultez
Écrire du texte dans un fichier Guide pratique pour écrire du texte dans des fichiers en Visual Basic
Ajouter du texte dans un fichier Guide pratique pour effectuer un ajout à des fichiers texte en Visual Basic

Voir aussi

S’applique à

WriteAllText(String, String, Boolean, Encoding)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Écrit du texte dans un fichier.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
static member WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public Shared Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Paramètres

file
String

Fichier dans lequel écrire.

text
String

Texte à écrire dans le fichier.

append
Boolean

True pour ajouter au contenu du fichier ; False pour remplacer le contenu du fichier.

encoding
Encoding

Encodage à utiliser lors de l'écriture dans le fichier.

Exceptions

Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\) ; il se termine par une barre oblique de fin.

file a la valeur Nothing.

Le fichier n'existe pas.

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

Le chemin d'accès dépasse la longueur maximale définie par le système.

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

Il n'y a pas assez de mémoire pour écrire la chaîne dans la mémoire tampon.

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple écrit la ligne "This is new text to be added." dans le fichier Test.txt, en remplaçant tout texte existant dans le fichier.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

Cet exemple écrit les noms des fichiers dans le Documents and Settings dossier FileList.txtdans , en insérant un retour chariot entre chacun d’eux pour une meilleure lisibilité.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Remarques

Si le fichier spécifié n’existe pas, il est créé.

Si l’encodage spécifié ne correspond pas à l’encodage existant du fichier, le codage spécifié est ignoré.

Notes

La WriteAllText méthode ouvre un fichier, y écrit, puis le ferme. Le code qui utilise la WriteAllText méthode est plus simple que le code qui utilise un StreamWriter objet. Toutefois, si vous ajoutez des chaînes à un fichier à l’aide d’une boucle, un StreamWriter objet peut fournir de meilleures performances, car vous n’avez qu’à ouvrir et fermer le fichier une seule fois. Pour plus d'informations, voir la méthode OpenTextFileWriter.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.WriteAllText méthode.

À Consultez
Écrire du texte dans un fichier Guide pratique pour écrire du texte dans des fichiers en Visual Basic
Ajouter du texte dans un fichier Guide pratique pour effectuer un ajout à des fichiers texte en Visual Basic

Voir aussi

S’applique à