Partager via

FileSystemProxy.WriteAllText Méthode

  • Référence

Définition

Espace de noms:
Microsoft.VisualBasic.MyServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.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)

Écrit du texte dans un fichier.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public void WriteAllText (string file, string text, bool append);
member this.WriteAllText : string * string * bool -> unit
Public 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. La valeur par défaut est False.

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 contient uniquement des espaces blancs ; elle contient des caractères non valides ; ou il s’agit d’un chemin d’accès 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 du dossier FileList.txtdans Documents and Settings , 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 Procédure : écrire du texte dans des fichiers
Ajouter du texte dans un fichier Procédure : ajouter du texte à des fichiers texte

Voir aussi

S’applique à

WriteAllText(String, String, Boolean, Encoding)

Écrit du texte dans un fichier.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public 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. La valeur par défaut est False.

encoding
Encoding

Encodage à utiliser lors de l'écriture dans le fichier. La valeur par défaut est UTF-8.

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 contient uniquement des espaces blancs ; elle contient des caractères non valides ; ou il s’agit d’un chemin d’accès 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 du dossier FileList.txtdans Documents and Settings , 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 Procédure : écrire du texte dans des fichiers
Ajouter du texte dans un fichier Procédure : ajouter du texte à des fichiers texte

Voir aussi

S’applique à