File.AppendAllText Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt die angegebene Zeichenfolge an die Datei an, und erstellt die Datei, wenn sie noch nicht vorhanden ist.
Überlädt
AppendAllText(String, ReadOnlySpan<Char>) |
Fügt die angegebene Zeichenfolge an die Datei an, und erstellt die Datei, wenn sie noch nicht vorhanden ist. |
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. |
AppendAllText(String, ReadOnlySpan<Char>, Encoding) |
Fügt die angegebene Zeichenfolge an die Datei an, und erstellt die Datei, wenn sie noch nicht vorhanden ist. |
AppendAllText(String, String, Encoding) |
Fügt die angegebene Zeichenfolge mithilfe der angegebenen Codierung an die Datei an, und erstellt die Datei, wenn sie noch nicht vorhanden ist. |
AppendAllText(String, ReadOnlySpan<Char>)
Fügt die angegebene Zeichenfolge an die Datei an, und erstellt die Datei, wenn sie noch nicht vorhanden ist.
public:
static void AppendAllText(System::String ^ path, ReadOnlySpan<char> contents);
public static void AppendAllText (string path, ReadOnlySpan<char> contents);
static member AppendAllText : string * ReadOnlySpan<char> -> unit
Public Shared Sub AppendAllText (path As String, contents As ReadOnlySpan(Of Char))
Parameter
- path
- String
Die Datei, an die angefügt werden soll.
- contents
- ReadOnlySpan<Char>
Die Zeichen, die in die Datei geschrieben werden sollen.
Ausnahmen
path
ist null
.
path
ist leer.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
path
eine Datei angegeben, die schreibgeschützt ist.
-oder-
path
eine ausgeblendete Datei angegeben.
-oder-
path
ein Verzeichnis angegeben.
-oder-
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
-oder-
Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.
path
weist ein ungültiges Format auf.
Hinweise
Aufgrund einer Zeichenfolge und eines Dateipfads öffnet diese Methode die angegebene Datei, fügt die Zeichenfolge an das Ende der Datei mit der angegebenen Codierung an,
und schließt dann die Datei. Das Dateihandle wird durch diese Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden. Die Methode erstellt die Datei.
wenn sie nicht vorhanden ist, aber keine neuen Verzeichnisse erstellt werden. Daher muss der Wert des Pfadparameters vorhandene Verzeichnisse enthalten.
Gilt für:
AppendAllText(String, String)
- Quelle:
- File.cs
- Quelle:
- File.cs
- 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.
public:
static void AppendAllText(System::String ^ path, System::String ^ contents);
public static void AppendAllText (string path, 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
.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path
ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode abfragen.
path
ist null
.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. ist das Verzeichnis nicht vorhanden oder befindet sich auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
path
eine Datei angegeben, die schreibgeschützt ist.
-oder-
Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.
-oder-
path
ein Verzeichnis angegeben.
-oder-
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
path
weist ein ungültiges Format auf.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der AppendAllText-Methode veranschaulicht, um am Ende einer Datei zusätzlichen Text hinzuzufügen. In diesem Beispiel wird eine Datei erstellt, wenn sie noch nicht vorhanden ist, und ihr Text hinzugefügt wird. 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
Angesichts 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 durch diese Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.
Die Methode erstellt die Datei, wenn sie nicht vorhanden ist, aber keine neuen Verzeichnisse erstellt. Daher muss der Wert des path
-Parameters vorhandene Verzeichnisse enthalten.
Gilt für:
AppendAllText(String, ReadOnlySpan<Char>, Encoding)
Fügt die angegebene Zeichenfolge an die Datei an, und erstellt die Datei, wenn sie noch nicht vorhanden ist.
public:
static void AppendAllText(System::String ^ path, ReadOnlySpan<char> contents, System::Text::Encoding ^ encoding);
public static void AppendAllText (string path, ReadOnlySpan<char> contents, System.Text.Encoding encoding);
static member AppendAllText : string * ReadOnlySpan<char> * System.Text.Encoding -> unit
Public Shared Sub AppendAllText (path As String, contents As ReadOnlySpan(Of Char), encoding As Encoding)
Parameter
- path
- String
Die Datei, an die angefügt werden soll.
- contents
- ReadOnlySpan<Char>
Die Zeichen, die in die Datei geschrieben werden sollen.
- encoding
- Encoding
Die Codierung, die auf die Zeichenfolge angewendet werden soll.
Ausnahmen
path
oder encoding
ist null
.
path
ist leer.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
path
eine Datei angegeben, die schreibgeschützt ist.
-oder-
path
eine ausgeblendete Datei angegeben.
-oder-
path
ein Verzeichnis angegeben.
-oder-
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
-oder-
Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.
path
weist ein ungültiges Format auf.
Hinweise
Aufgrund einer Zeichenfolge und eines Dateipfads öffnet diese Methode die angegebene Datei, fügt die Zeichenfolge an das Ende der Datei mit der angegebenen Codierung an,
und schließt dann die Datei. Das Dateihandle wird durch diese Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden. Die Methode erstellt die Datei.
wenn sie nicht vorhanden ist, aber keine neuen Verzeichnisse erstellt werden. Daher muss der Wert des Pfadparameters vorhandene Verzeichnisse enthalten.
Gilt für:
AppendAllText(String, String, Encoding)
- Quelle:
- File.cs
- Quelle:
- File.cs
- Quelle:
- File.cs
Fügt die angegebene Zeichenfolge mithilfe der angegebenen Codierung an die Datei an, und erstellt die Datei, wenn sie noch nicht 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);
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
.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path
ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode abfragen.
path
ist null
.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (z. B. ist das Verzeichnis nicht vorhanden oder befindet sich auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
path
eine Datei angegeben, die schreibgeschützt ist.
-oder-
Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.
-oder-
path
ein Verzeichnis angegeben.
-oder-
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
path
weist ein ungültiges Format auf.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der AppendAllText-Methode veranschaulicht, um am Ende einer Datei zusätzlichen Text hinzuzufügen. In diesem Beispiel wird eine Datei erstellt, wenn sie noch nicht vorhanden ist, und ihr Text hinzugefügt wird. 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
Angesichts 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 die Datei. Das Dateihandle wird durch diese Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.
Die Methode erstellt die Datei, wenn sie nicht vorhanden ist, aber keine neuen Verzeichnisse erstellt. Daher muss der Wert des path
-Parameters vorhandene Verzeichnisse enthalten.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für