File.AppendText(String) Metódus

Definíció

Névtér:

System.IO

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

File.cs

Létrehoz egy olyan fájlt StreamWriter , amely hozzáfűzi az UTF-8 kódolt szöveget egy meglévő fájlhoz vagy egy új fájlhoz, ha a megadott fájl nem létezik.

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

Paraméterek

path

String

A hozzáfűzni kívánt fájl elérési útja.

Válaszok

StreamWriter

Egy streamíró, amely hozzáfűzi az UTF-8 kódolt szöveget a megadott fájlhoz vagy egy új fájlhoz.

Kivételek

UnauthorizedAccessException

A hívó nem rendelkezik a szükséges engedéllyel.

ArgumentException

.NET Framework és .NET Core 2.1-nél régebbi verziói: path nulla hosszúságú sztring, csak szóközt tartalmaz, vagy egy vagy több érvénytelen karaktert tartalmaz. A metódussal GetInvalidPathChars() érvénytelen karaktereket kérdezhet le.

ArgumentNullException

path az null.

PathTooLongException

A megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

DirectoryNotFoundException

A megadott elérési út érvénytelen (például a könyvtár nem létezik, vagy nem leképezett meghajtón található).

NotSupportedException

path formátuma érvénytelen.

Példák

Az alábbi példa szöveget fűz egy fájlhoz. A metódus új fájlt hoz létre, ha a fájl nem létezik. A C meghajtón elnevezett temp könyvtárnak azonban léteznie kell ahhoz, hogy a példa sikeresen befejeződjön.

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);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    use 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.
do
    use sw = File.AppendText path
    sw.WriteLine "This"
    sw.WriteLine "is Extra"
    sw.WriteLine "Text"

// Open the file to read from.
do
    use sr = File.OpenText path

    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

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

Megjegyzések

Ez a módszer egyenértékű a konstruktor túlterhelésével StreamWriter(String, Boolean) . Ha a megadott path fájl nem létezik, létrejön. Ha a fájl létezik, írjon műveleteket a StreamWriter hozzáfűző szöveghez a fájlhoz. A fájl megnyitásakor további szálak is elolvashatók.

A path paraméter relatív vagy abszolút elérésiút-információkat adhat meg. A relatív elérési út adatai az aktuális munkakönyvtárhoz viszonyítva értelmezve lesznek. Az aktuális munkakönyvtár beszerzéséhez lásd: GetCurrentDirectory.

A path paraméter nem megkülönbözteti a kis- és nagybetűk értékét.

A gyakori I/O-feladatok listáját a Gyakori I/O-feladatok című témakörben találja.

Lásd még

• StreamWriter
• Fájl és folyam I/O
• Szöveg olvasása fájlból
• Útmutató: Szöveg írása fájlba
• Útmutató: Olvasás és írás újonnan létrehozott adatfájlba