Číst v angličtině

Sdílet prostřednictvím


File.AppendAllText Metoda

Definice

Připojí zadaný řetězec k souboru a vytvoří soubor, pokud ještě neexistuje.

Přetížení

AppendAllText(String, ReadOnlySpan<Char>)

Připojí zadaný řetězec k souboru a vytvoří soubor, pokud ještě neexistuje.

AppendAllText(String, String)

Otevře soubor, připojí zadaný řetězec k souboru a pak soubor zavře. Pokud soubor neexistuje, tato metoda vytvoří soubor, zapíše zadaný řetězec do souboru a pak soubor zavře.

AppendAllText(String, ReadOnlySpan<Char>, Encoding)

Připojí zadaný řetězec k souboru a vytvoří soubor, pokud ještě neexistuje.

AppendAllText(String, String, Encoding)

Připojí zadaný řetězec k souboru pomocí zadaného kódování a vytvoří soubor, pokud ještě neexistuje.

AppendAllText(String, ReadOnlySpan<Char>)

Připojí zadaný řetězec k souboru a vytvoří soubor, pokud ještě neexistuje.

public static void AppendAllText (string path, ReadOnlySpan<char> contents);

Parametry

path
String

Soubor, ke který se má připojit.

contents
ReadOnlySpan<Char>

Znaky pro zápis do souboru.

Výjimky

path je null.

path je prázdný.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Zadaná cesta je neplatná (například je na nemapované jednotce).

Při otevírání souboru došlo k vstupně-výstupní chybě.

path zadali soubor, který je jen pro čtení.

-nebo-

path zadali skrytý soubor.

-nebo-

path zadali adresář.

-nebo-

Volající nemá požadované oprávnění.

-nebo-

Tato operace není na aktuální platformě podporovaná.

path je v neplatném formátu.

Poznámky

Vzhledem k řetězci a cestě k souboru tato metoda otevře zadaný soubor, připojí řetězec na konec souboru pomocí zadaného kódování.

a pak soubor zavře. Tento způsob zaručuje uzavření popisovače souboru, a to i v případě, že jsou vyvolány výjimky. Metoda vytvoří soubor.

pokud neexistuje, ale nevytvoří nové adresáře. Proto hodnota parametru cesty musí obsahovat existující adresáře.

Platí pro

.NET 9
Produkt Verze
.NET 9

AppendAllText(String, String)

Zdroj:
File.cs
Zdroj:
File.cs
Zdroj:
File.cs

Otevře soubor, připojí zadaný řetězec k souboru a pak soubor zavře. Pokud soubor neexistuje, tato metoda vytvoří soubor, zapíše zadaný řetězec do souboru a pak soubor zavře.

public static void AppendAllText (string path, string contents);
public static void AppendAllText (string path, string? contents);

Parametry

path
String

Soubor pro připojení zadaného řetězce.

contents
String

Řetězec, který se má připojit k souboru.

Výjimky

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody GetInvalidPathChars() můžete zadat dotaz na neplatné znaky.

path je null.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Zadaná cesta je neplatná (například adresář neexistuje nebo je na nemapované jednotce).

Při otevírání souboru došlo k vstupně-výstupní chybě.

path zadali soubor, který je jen pro čtení.

-nebo-

Tato operace není na aktuální platformě podporovaná.

-nebo-

path zadali adresář.

-nebo-

Volající nemá požadované oprávnění.

path je v neplatném formátu.

Volající nemá požadované oprávnění.

Příklady

Následující příklad kódu ukazuje použití AppendAllText metoda přidat další text na konec souboru. V tomto příkladu se vytvoří soubor, pokud ještě neexistuje, a text se do něj přidá. Adresář s názvem temp na jednotce C však musí existovat, aby se příklad úspěšně dokončil.

using System;
using System.IO;
using System.Text;

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.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}

Poznámky

Vzhledem k řetězci a cestě k souboru tato metoda otevře zadaný soubor, připojí řetězec na konec souboru a pak soubor zavře. Tento způsob zaručuje uzavření popisovače souboru, a to i v případě, že jsou vyvolány výjimky.

Metoda vytvoří soubor, pokud neexistuje, ale nevytvoří nové adresáře. Proto hodnota parametru path musí obsahovat existující adresáře.

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

AppendAllText(String, ReadOnlySpan<Char>, Encoding)

Připojí zadaný řetězec k souboru a vytvoří soubor, pokud ještě neexistuje.

public static void AppendAllText (string path, ReadOnlySpan<char> contents, System.Text.Encoding encoding);

Parametry

path
String

Soubor, ke který se má připojit.

contents
ReadOnlySpan<Char>

Znaky pro zápis do souboru.

encoding
Encoding

Kódování, které se má použít na řetězec.

Výjimky

path nebo encoding je null.

path je prázdný.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Zadaná cesta je neplatná (například je na nemapované jednotce).

Při otevírání souboru došlo k vstupně-výstupní chybě.

path zadali soubor, který je jen pro čtení.

-nebo-

path zadali skrytý soubor.

-nebo-

path zadali adresář.

-nebo-

Volající nemá požadované oprávnění.

-nebo-

Tato operace není na aktuální platformě podporovaná.

path je v neplatném formátu.

Poznámky

Vzhledem k řetězci a cestě k souboru tato metoda otevře zadaný soubor, připojí řetězec na konec souboru pomocí zadaného kódování.

a pak soubor zavře. Tento způsob zaručuje uzavření popisovače souboru, a to i v případě, že jsou vyvolány výjimky. Metoda vytvoří soubor.

pokud neexistuje, ale nevytvoří nové adresáře. Proto hodnota parametru cesty musí obsahovat existující adresáře.

Platí pro

.NET 9
Produkt Verze
.NET 9

AppendAllText(String, String, Encoding)

Zdroj:
File.cs
Zdroj:
File.cs
Zdroj:
File.cs

Připojí zadaný řetězec k souboru pomocí zadaného kódování a vytvoří soubor, pokud ještě neexistuje.

public static void AppendAllText (string path, string contents, System.Text.Encoding encoding);
public static void AppendAllText (string path, string? contents, System.Text.Encoding encoding);

Parametry

path
String

Soubor pro připojení zadaného řetězce.

contents
String

Řetězec, který se má připojit k souboru.

encoding
Encoding

Kódování znaků, které se má použít.

Výjimky

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody GetInvalidPathChars() můžete zadat dotaz na neplatné znaky.

path je null.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Zadaná cesta je neplatná (například adresář neexistuje nebo je na nemapované jednotce).

Při otevírání souboru došlo k vstupně-výstupní chybě.

path zadali soubor, který je jen pro čtení.

-nebo-

Tato operace není na aktuální platformě podporovaná.

-nebo-

path zadali adresář.

-nebo-

Volající nemá požadované oprávnění.

path je v neplatném formátu.

Volající nemá požadované oprávnění.

Příklady

Následující příklad kódu ukazuje použití AppendAllText metoda přidat další text na konec souboru. V tomto příkladu se vytvoří soubor, pokud ještě neexistuje, a text se do něj přidá. Adresář s názvem temp na jednotce C však musí existovat, aby se příklad úspěšně dokončil.

using System;
using System.IO;
using System.Text;

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.
            string createText = "Hello and Welcome" + Environment.NewLine;
            File.WriteAllText(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string readText = File.ReadAllText(path);
        Console.WriteLine(readText);
    }
}

Poznámky

Při zadání řetězce a cesty k souboru tato metoda otevře zadaný soubor, připojí řetězec na konec souboru pomocí zadaného kódování a pak soubor zavře. Tento způsob zaručuje uzavření popisovače souboru, a to i v případě, že jsou vyvolány výjimky.

Metoda vytvoří soubor, pokud neexistuje, ale nevytvoří nové adresáře. Proto hodnota parametru path musí obsahovat existující adresáře.

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0