FileSystemProxy.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)
É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 -> unitPublic 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
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.
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 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
- Encoding
- WriteAllText(String, String, Boolean)
- Objets (Visual Basic)
- Écriture dans des fichiers en Visual Basic
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 -> unitPublic 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
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.
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 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 à
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour