File.AppendText(String) File.AppendText(String) File.AppendText(String) File.AppendText(String) Method

Definition

Erstellt einen StreamWriter, der UTF-8 codierten Text an eine vorhandene Datei anfügt oder an eine neue Datei, wenn die angegebene Datei nicht vorhanden ist.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

Parameter

path
String String String String

Der Pfad zu der Datei, an die angefügt wird.The path to the file to append to.

Gibt zurück

Ein Streamwriter, der UTF-8 codierten Text an die angegebene Datei oder eine neue Datei anfügt.A stream writer that appends UTF-8 encoded text to the specified file or to a new file.

Ausnahmen

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Der angegebene Pfad ist ungültig (z. B. ist das Verzeichnis nicht vorhanden oder befindet sich auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

path weist ein ungültiges Format auf.path is in an invalid format.

Beispiele

Im folgende Beispiel wird eine Datei Text hinzufügt.The following example appends text to a file. Die Methode erstellt eine neue Datei, wenn die Datei nicht vorhanden.The method creates a new file if the file doesn't exist. Das Verzeichnis jedoch mit dem Namen temp auf Laufwerk C muss vorhanden sein, damit das Beispiel erfolgreich abgeschlossen.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
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

Hinweise

Diese Methode entspricht der StreamWriter(String, Boolean) Überladung des Konstruktors.This method is equivalent to the StreamWriter(String, Boolean) constructor overload. Wenn die Datei durch angegeben path nicht vorhanden ist, wird er erstellt.If the file specified by path does not exist, it is created. Wenn die Datei vorhanden ist, Schreiben Sie Vorgänge für die StreamWriter Anfügen von Text in die Datei.If the file does exist, write operations to the StreamWriter append text to the file. Zusätzliche Threads sind zulässig, um die Datei zu lesen, während er geöffnet ist.Additional threads are permitted to read the file while it is open.

Die path Parameter dürfen relativer oder absoluter Pfad angegeben werden.The path parameter is permitted to specify relative or absolute path information. Relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.Relative path information is interpreted as relative to the current working directory. Um das aktuelle Arbeitsverzeichnis zu erhalten, finden Sie unter GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Die path Parameter wird nicht beachtet.The path parameter is not case-sensitive.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Anfügen an die angegebene Datei.for appending to the specified file. Zugeordnete Enumeration: AppendAssociated enumeration: Append

Gilt für:

Siehe auch