My.Computer.FileSystem.OpenTextFileWriter, méthode

Article
08/21/2008

Mise à jour : novembre 2007

' Usage
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append)
Dim value As System.IO.StreamWriter = My.Computer.FileSystem.OpenTextFileWriter(file ,append ,encoding)
' Declaration
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean _
) As System.IO.StreamWriter
' -or-
Public Function OpenTextFileWriter( _
   ByVal file As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
) As System.IO.StreamWriter

Paramètres

file
String. Fichier dans lequel écrire. Obligatoire.
append
Boolean. Spécifie s'il faut ajouter ou remplacer les informations contenues dans le fichier. Obligatoire.
encoding
Encoding. Codage à utiliser pour écrire dans le fichier. La valeur par défaut est UTF8.

Valeur de retour

StreamWriter

Exceptions

La condition ci-dessous peut lever une exception :

Le nom du fichier se termine par une barre oblique finale (ArgumentException).

Notes

La méthode OpenTextFileWriter ouvre et initialise un flux de données pour un fichier puis retourne l'objet StreamWriter pour ce flux de données. Vous pouvez écrire dans le flux de données autant de fois que nécessaire, puis le fermer lorsque vous avez terminé.

Remarque :
Vous devez appeler la méthode Close sur l'objet StreamWriter pour vous assurer que toutes les données sont écrites correctement dans le flux sous-jacent.

Si le paramètre append a la valeur True, la méthode ajoute le texte au fichier ; sinon, le texte existant du fichier est remplacé.

Si vous écrivez uniquement quelques chaînes dans un fichier, il serait peut-être plus simple d'utiliser la méthode WriteAllText. Pour plus d'informations, consultez My.Computer.FileSystem.WriteAllText, méthode.

Tâches

Le tableau suivant présente un exemple de tâche impliquant la méthode My.Computer.FileSystem.OpenTextFileWriter.

Pour	Consultez
Écrire du texte da ns un fichier en utilisant un StreamWriter	Comment : écrire du texte dans des fichiers à l'aide de Streamwriter dans Visual Basic

Exemple

Cet exemple ouvre un StreamWriter avec la méthode My.Computer.FileSystem.OpenTextFileWriter et l'utilise pour écrire une chaîne dans un fichier texte à l'aide de la méthode WriteLine de la classe StreamWriter.

Dim file As System.IO.StreamWriter
file = My.Computer.FileSystem.OpenTextFileWriter("c:\test.txt", True)
file.WriteLine("Here is the first string.")
file.Close()

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :FileSystemProxy (fournit l'accès à FileSystem)

Assembly : bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Oui
Service Windows	Oui
Site Web	Oui