File.AppendAllText Methode

Definition

Namespace:

System.IO

Assembly:

System.Runtime.dll

Fügt die angegebene Zeichenfolge an die Datei an und erstellt die Datei, wenn sie nicht bereits vorhanden ist.

Überlädt

AppendAllText(String, String)	Öffnet eine Datei, fügt die angegebene Zeichenfolge an die Datei an und schließt dann die Datei. Wenn die Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebene Zeichenfolge in die Datei und schließt die Datei dann.
AppendAllText(String, String, Encoding)	Fügt die angegebene Zeichenfolge unter Verwendung der angegebenen Codierung an die Datei an und erstellt die Datei, wenn sie nicht bereits vorhanden ist.

AppendAllText(String, String)

Quelle:

File.cs

Öffnet eine Datei, fügt die angegebene Zeichenfolge an die Datei an und schließt dann die Datei. Wenn die Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebene Zeichenfolge in die Datei und schließt die Datei dann.

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents);

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

static member AppendAllText : string * string -> unit

Public Shared Sub AppendAllText (path As String, contents As String)

Parameter

path

String

Die Datei, an die die angegebene Zeichenfolge angefügt werden soll.

contents

String

Die Zeichenfolge, die an die Datei angefügt werden soll.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (z. B. ist das Verzeichnis nicht vorhanden oder befindet sich auf einem nicht zugeordneten Laufwerk).

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

path hat eine schreibgeschützte Datei angegeben.

- oder -

Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.

- oder -

path hat ein Verzeichnis angegeben.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

NotSupportedException

path weist ein ungültiges Format auf.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der AppendAllText -Methode veranschaulicht, um zusätzlichen Text am Ende einer Datei hinzuzufügen. In diesem Beispiel wird eine Datei erstellt, wenn sie noch nicht vorhanden ist, und ihr Text hinzugefügt. Das Verzeichnis mit dem Namen temp auf Laufwerk C muss jedoch vorhanden sein, damit das Beispiel erfolgreich abgeschlossen werden kann.

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

open System
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.
    let 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.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText)

// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"

Imports System.IO
Imports System.Text

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 File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText)
        End If

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

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Hinweise

Bei Verwendung einer Zeichenfolge und eines Dateipfads öffnet diese Methode die angegebene Datei, fügt die Zeichenfolge an das Ende der Datei an und schließt dann die Datei. Das Dateihandle wird von dieser Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.

Die -Methode erstellt die Datei, wenn sie nicht vorhanden ist, aber keine neuen Verzeichnisse. Daher muss der Wert des path Parameters vorhandene Verzeichnisse enthalten.

AppendAllText(String, String, Encoding)

Quelle:

File.cs

Fügt die angegebene Zeichenfolge unter Verwendung der angegebenen Codierung an die Datei an und erstellt die Datei, wenn sie nicht bereits vorhanden ist.

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents, System::Text::Encoding ^ encoding);

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

static member AppendAllText : string * string * System.Text.Encoding -> unit

Public Shared Sub AppendAllText (path As String, contents As String, encoding As Encoding)

Parameter

path

String

Die Datei, an die die angegebene Zeichenfolge angefügt werden soll.

contents

String

Die Zeichenfolge, die an die Datei angefügt werden soll.

encoding

Encoding

Die zu verwendende Zeichencodierung.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen älter als 2.1: path ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (z. B. ist das Verzeichnis nicht vorhanden oder befindet sich auf einem nicht zugeordneten Laufwerk).

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

path hat eine schreibgeschützte Datei angegeben.

- oder -

Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.

- oder -

path hat ein Verzeichnis angegeben.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

NotSupportedException

path weist ein ungültiges Format auf.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der AppendAllText -Methode veranschaulicht, um zusätzlichen Text am Ende einer Datei hinzuzufügen. In diesem Beispiel wird eine Datei erstellt, wenn sie noch nicht vorhanden ist, und ihr Text hinzugefügt. Das Verzeichnis mit dem Namen temp auf Laufwerk C muss jedoch vorhanden sein, damit das Beispiel erfolgreich abgeschlossen werden kann.

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

open System
open System.IO
open System.Text

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.
    let 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.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText, Encoding.UTF8)

// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"

Imports System.IO
Imports System.Text

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.
            Dim createText As String = "Hello and Welcome" + Environment.NewLine
            File.WriteAllText(path, createText, Encoding.UTF8)
        End If

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

        ' Open the file to read from.
        Dim readText As String = File.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Hinweise

Bei Verwendung einer Zeichenfolge und eines Dateipfads öffnet diese Methode die angegebene Datei, fügt die Zeichenfolge mit der angegebenen Codierung an das Ende der Datei an und schließt dann die Datei. Das Dateihandle wird von dieser Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.

Die -Methode erstellt die Datei, wenn sie nicht vorhanden ist, aber keine neuen Verzeichnisse. Daher muss der Wert des path Parameters vorhandene Verzeichnisse enthalten.