Freigeben über


FileSystemProxy.WriteAllText Methode

Definition

Schreibt Text in eine Datei.

Überlädt

WriteAllText(String, String, Boolean)

Schreibt Text in eine Datei.

WriteAllText(String, String, Boolean, Encoding)

Schreibt Text in eine Datei.

WriteAllText(String, String, Boolean)

Schreibt Text in eine Datei.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public void WriteAllText (string file, string text, bool append);
member this.WriteAllText : string * string * bool -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean)

Parameter

file
String

Die Datei, in die geschrieben werden soll.

text
String

Text, der in eine Datei geschrieben werden soll.

append
Boolean

True, wenn Daten an den Inhalt der Datei angefügt werden sollen, False, wenn der Inhalt der Datei überschrieben werden soll. Der Standardwert ist False.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.

file ist Nothing.

Die Datei ist nicht vorhanden.

Die Datei wird von einem anderen Prozess verwendet, oder ein E/A-Fehler tritt auf.

Der Pfad überschreitet die im System definierte maximale Länge.

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

Es ist nicht genügend Arbeitsspeicher vorhanden, um die Zeichenfolge in den Puffer zu schreiben.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Beispiele

In diesem Beispiel wird die Zeile "This is new text to be added." in die Datei Test.txtgeschrieben, wobei der vorhandene Text in der Datei überschrieben wird.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

In diesem Beispiel werden die Namen der Dateien im Documents and Settings Ordner in FileList.txtgeschrieben, wobei ein Wagenrücklauf zwischen beiden eingefügt wird, um die Lesbarkeit zu verbessern.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Hinweise

Die UTF-8-Codierung wird verwendet, um in die Datei zu schreiben. Um eine andere Codierung anzugeben, verwenden Sie eine andere Überladung der WriteAllText -Methode.

Ist die angegebene Datei noch nicht vorhanden, wird diese erstellt.

Wenn die angegebene Codierung nicht mit der vorhandenen Codierung der Datei übereinstimmt, wird die angegebene Codierung ignoriert.

Hinweis

Die WriteAllText -Methode öffnet eine Datei, schreibt in sie und schließt sie dann. Code, der die WriteAllText -Methode verwendet, ist einfacher als Code, der ein StreamWriter -Objekt verwendet. Wenn Sie jedoch Zeichenfolgen mithilfe einer Schleife zu einer Datei hinzufügen, kann ein StreamWriter Objekt eine bessere Leistung bieten, da Sie die Datei nur einmal öffnen und schließen müssen. Weitere Informationen finden Sie unter der Methode OpenTextFileWriter.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.WriteAllText -Methode betreffen.

Beschreibung Siehe
Schreiben von Text in eine Datei Vorgehensweise: Schreiben von Text in Dateien
Anfügen von Text an eine Datei Vorgehensweise: Anfügen an Textdateien

Weitere Informationen

Gilt für:

WriteAllText(String, String, Boolean, Encoding)

Schreibt Text in eine Datei.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Parameter

file
String

Die Datei, in die geschrieben werden soll.

text
String

Text, der in eine Datei geschrieben werden soll.

append
Boolean

True, wenn Daten an den Inhalt der Datei angefügt werden sollen, False, wenn der Inhalt der Datei überschrieben werden soll. Der Standardwert ist False.

encoding
Encoding

Die beim Schreiben in die Datei zu verwendende Codierung. Der Standardwert ist UTF-8.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.

file ist Nothing.

Die Datei ist nicht vorhanden.

Die Datei wird von einem anderen Prozess verwendet, oder ein E/A-Fehler tritt auf.

Der Pfad überschreitet die im System definierte maximale Länge.

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

Es ist nicht genügend Arbeitsspeicher vorhanden, um die Zeichenfolge in den Puffer zu schreiben.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Beispiele

In diesem Beispiel wird die Zeile "This is new text to be added." in die Datei Test.txtgeschrieben, wobei der vorhandene Text in der Datei überschrieben wird.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

In diesem Beispiel werden die Namen der Dateien im Documents and Settings Ordner in FileList.txtgeschrieben, wobei ein Wagenrücklauf zwischen beiden eingefügt wird, um die Lesbarkeit zu verbessern.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Hinweise

Ist die angegebene Datei noch nicht vorhanden, wird diese erstellt.

Wenn die angegebene Codierung nicht mit der vorhandenen Codierung der Datei übereinstimmt, wird die angegebene Codierung ignoriert.

Hinweis

Die WriteAllText -Methode öffnet eine Datei, schreibt in sie und schließt sie dann. Code, der die WriteAllText -Methode verwendet, ist einfacher als Code, der ein StreamWriter -Objekt verwendet. Wenn Sie jedoch Zeichenfolgen mithilfe einer Schleife zu einer Datei hinzufügen, kann ein StreamWriter Objekt eine bessere Leistung bieten, da Sie die Datei nur einmal öffnen und schließen müssen. Weitere Informationen finden Sie unter der Methode OpenTextFileWriter.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.WriteAllText -Methode betreffen.

Beschreibung Siehe
Schreiben von Text in eine Datei Vorgehensweise: Schreiben von Text in Dateien
Anfügen von Text an eine Datei Vorgehensweise: Anfügen an Textdateien

Weitere Informationen

Gilt für: