Assembly : mscorlib (dans mscorlib.dll)
SyntaxePublic Shared Function AppendText ( _ path As String _ ) As StreamWriter
Dim path As String Dim returnValue As StreamWriter returnValue = File.AppendText(path)
public static StreamWriter AppendText ( string path )
public: static StreamWriter^ AppendText ( String^ path )
public static StreamWriter AppendText ( String path )
public static function AppendText ( path : String ) : StreamWriter
Paramètres
- path
Chemin d'accès du fichier dans lequel le texte est ajouté.
Valeur de retour
StreamWriter qui ajoute du texte codé UTF-8 à un fichier existant.
Exceptions| Type d'exception | Condition |
|---|---|
| L'appelant n'a pas l'autorisation requise. | |
| path est une chaîne de longueur nulle, ne contient que des espaces blancs ou contient un ou plusieurs caractères non valides comme défini par InvalidPathChars. | |
| path a la valeur référence Null (Nothing en Visual Basic). | |
| Le chemin d'accès ou le nom de fichier spécifié ou les deux excèdent la longueur maximale définie par le système. Par exemple, sur les plates-formes Windows, les chemins d'accès et les noms de fichiers ne doivent pas dépasser, respectivement, 248 et 260 caractères. | |
| Le chemin d'accès spécifié n'est pas valide (il se trouve, par exemple, sur un lecteur non mappé). | |
| Le format de path est non valide. |
NotesCette méthode équivaut à la surcharge du constructeur StreamWriter(String,Boolean). Si le fichier spécifié par path n'existe pas, il est créé. Si le fichier existe, les opérations d'écriture dans StreamWriter ajoutent du texte au fichier. Les threads supplémentaires sont autorisés à lire le fichier pendant qu'il est ouvert.
Le paramètre path est autorisé à spécifier des informations sur le chemin d'accès relatif ou absolu. Les informations sur le chemin d'accès relatif sont interprétées comme étant relatives au répertoire de travail en cours. Pour obtenir le répertoire de travail en cours, consultez GetCurrentDirectory.
Le paramètre path ne respecte pas la casse.
Pour obtenir un exemple d'utilisation de cette méthode, consultez la section Exemple. Le tableau suivant répertorie des exemples d'autres tâches d'E/S courantes ou apparentées.
| Pour effectuer cette opération... | Consultez l'exemple qui se trouve dans cette rubrique... |
|---|---|
| Créer un fichier texte. | |
| Écrire dans un fichier texte. | |
| Lire à partir d'un fichier texte. |
ExempleL'exemple suivant ajoute du texte à un fichier.
Imports System Imports System.IO Public Class Test Public Shared Sub Main() Dim path As String = "c:\temp\MyTest.txt" Dim sw As StreamWriter ' This text is added only once to the file. If File.Exists(path) = False Then ' Create a file to write to. sw = File.CreateText(path) sw.WriteLine("Hello") sw.WriteLine("And") sw.WriteLine("Welcome") sw.Flush() sw.Close() End If ' This text is always added, making the file longer over time ' if it is not deleted. sw = File.AppendText(path) sw.WriteLine("This") sw.WriteLine("is Extra") sw.WriteLine("Text") sw.Flush() sw.Close() ' Open the file to read from. Dim sr As StreamReader = File.OpenText(path) Dim s As String Do While sr.Peek() >= 0 s = sr.ReadLine() Console.WriteLine(s) Loop sr.Close() End Sub End Class
using System; using System.IO; class Test { public static void Main() { string path = @"c:\temp\MyTest.txt"; // This text is added only once to the file. if (!File.Exists(path)) { // Create a file to write to. using (StreamWriter sw = File.CreateText(path)) { sw.WriteLine("Hello"); sw.WriteLine("And"); sw.WriteLine("Welcome"); } } // This text is always added, making the file longer over time // if it is not deleted. using (StreamWriter sw = File.AppendText(path)) { sw.WriteLine("This"); sw.WriteLine("is Extra"); sw.WriteLine("Text"); } // Open the file to read from. using (StreamReader sr = File.OpenText(path)) { string s = ""; while ((s = sr.ReadLine()) != null) { Console.WriteLine(s); } } } }
using namespace System; using namespace System::IO; int main() { String^ path = "c:\\temp\\MyTest.txt"; // This text is added only once to the file. if ( !File::Exists( path ) ) { // Create a file to write to. StreamWriter^ sw = File::CreateText( path ); try { sw->WriteLine( "Hello" ); sw->WriteLine( "And" ); sw->WriteLine( "Welcome" ); } finally { if ( sw ) delete (IDisposable^)sw; } } // This text is always added, making the file longer over time // if it is not deleted. StreamWriter^ sw = File::AppendText( path ); try { sw->WriteLine( "This" ); sw->WriteLine( "is Extra" ); sw->WriteLine( "Text" ); } finally { if ( sw ) delete (IDisposable^)sw; } // Open the file to read from. StreamReader^ sr = File::OpenText( path ); try { String^ s = ""; while ( s = sr->ReadLine() ) { Console::WriteLine( s ); } } finally { if ( sr ) delete (IDisposable^)sr; } }
import System.*; import System.IO.*; class Test { public static void main(String[] args) { String path = "c:\\temp\\MyTest.txt"; // This text is added only once to the file. if (!(File.Exists(path))) { // Create a file to write to. StreamWriter sw = File.CreateText(path); try { sw.WriteLine("Hello"); sw.WriteLine("And"); sw.WriteLine("Welcome"); } finally { sw.Dispose(); } } // This text is always added, making the file longer over time // if it is not deleted. StreamWriter sw = File.AppendText(path); try { sw.WriteLine("This"); sw.WriteLine("is Extra"); sw.WriteLine("Text"); } finally { sw.Dispose(); } // Open the file to read from. StreamReader sr = File.OpenText(path); try { String s = ""; while ((s = sr.ReadLine())!= null) { Console.WriteLine(s); } } finally { sr.Dispose(); } } //main } //Test
Sécurité .NET Framework- FileIOPermission pour ajouter au fichier spécifié. Énumération associée : FileIOPermissionAccess.Append
Plates-formesWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Informations de version
Outils (masquer)
S'enregistrer
Liste des Membres
Qui est en ligne?
FAQ