FileSystem.WriteAllText Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
É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 -> unitPublic 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 -> unitPublic 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 |
