FileSystem.WriteAllText Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

É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

É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

ArgumentException

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.

ArgumentNullException

file a la valeur Nothing.

FileNotFoundException

Le fichier n'existe pas.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

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

ArgumentException

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.

ArgumentNullException

file a la valeur Nothing.

FileNotFoundException

Le fichier n'existe pas.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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

• Encoding