File.AppendText(String) Metodo

Definizione

Crea un oggetto StreamWriter che aggiunge testo con codifica UTF-8 a un file esistente o a un nuovo file se quello specificato non esiste.Creates a StreamWriter that appends UTF-8 encoded text to an existing file, or to a new file if the specified file does not exist.

public:
 static System::IO::StreamWriter ^ AppendText(System::String ^ path);
public static System.IO.StreamWriter AppendText (string path);
static member AppendText : string -> System.IO.StreamWriter
Public Shared Function AppendText (path As String) As StreamWriter

Parametri

path
String

Percorso del file al quale aggiungere testo.The path to the file to append to.

Restituisce

Writer di flusso che aggiunge testo con codifica UTF-8 al file specificato o a un nuovo file.A stream writer that appends UTF-8 encoded text to the specified file or to a new file.

Eccezioni

Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path è null.path is null.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il percorso specificato non è valido, ad esempio la directory non esiste o si trova in un'unità non mappata.The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

Il formato di path non è valido.path is in an invalid format.

Esempi

Nell'esempio seguente viene aggiunto il testo a un file.The following example appends text to a file. Il metodo crea un nuovo file se il file non esiste.The method creates a new file if the file doesn't exist. Tuttavia, per completare correttamente l'esempio, è necessario che la directory denominata temp sull'unità C esista.However, the directory named temp on drive C must exist for the example to complete successfully.

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;
   }
}
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);
            }
        }
    }
}
Imports System.IO

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    ' This text is added only once to the file. 
    If Not File.Exists(path) Then
      ' Create a file to write to.
      Using sw As StreamWriter = File.CreateText(path)
        sw.WriteLine("Hello")
        sw.WriteLine("And")
        sw.WriteLine("Welcome")
      End Using
    End If

    ' This text is always added, making the file longer over time 
    ' if it is not deleted.
    Using sw As StreamWriter = File.AppendText(path)
      sw.WriteLine("This")
      sw.WriteLine("is Extra")
      sw.WriteLine("Text")
    End Using

    ' Open the file to read from. 
    Using sr As StreamReader = File.OpenText(path)
      Do While sr.Peek() >= 0
        Console.WriteLine(sr.ReadLine())
      Loop
    End Using

  End Sub
End Class

Commenti

Questo metodo è equivalente all'overload del costruttore StreamWriter(String, Boolean).This method is equivalent to the StreamWriter(String, Boolean) constructor overload. Se il file specificato da path non esiste, viene creato.If the file specified by path does not exist, it is created. Se il file esiste, le operazioni di scrittura nel StreamWriter aggiungono testo al file.If the file does exist, write operations to the StreamWriter append text to the file. Ai thread aggiuntivi è consentito leggere il file mentre è aperto.Additional threads are permitted to read the file while it is open.

Al parametro path è consentito specificare le informazioni sul percorso relativo o assoluto.The path parameter is permitted to specify relative or absolute path information. Le informazioni sul percorso relativo vengono interpretate in relazione alla directory di lavoro corrente.Relative path information is interpreted as relative to the current working directory. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Il parametro path non distingue tra maiuscole e minuscole.The path parameter is not case-sensitive.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Sicurezza

FileIOPermission
per l'accodamento al file specificato.for appending to the specified file. Enumerazione associata: AppendAssociated enumeration: Append

Si applica a

Vedi anche