My.Computer.FileSystem.OpenTextFileWriter, méthode
Mise à jour : novembre 2007
Ouvre StreamWriter.
' 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
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 |
Autorisations
L'autorisation suivante peut être nécessaire :
Autorisation |
Description |
---|---|
Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted. |
Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.
Voir aussi
Tâches
Comment : écrire du texte dans des fichiers à l'aide de Streamwriter dans Visual Basic