FileSystemProxy.WriteAllText 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.
Schreibt Text in eine Datei.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean)Parameter
- file
- String
Datei, in die geschrieben werden soll.
- text
- String
Text, der in die Datei geschrieben werden soll.
- append
- Boolean
True an den Inhalt der Datei anzufügen; False um den Inhalt der Datei zu überschreiben. Der Standardwert ist False.
Ausnahmen
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen 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 vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Es ist nicht genügend Arbeitsspeicher vorhanden, um die Zeichenfolge in puffern zu schreiben.
Der Benutzer verfügt nicht über erforderliche 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 den Ordner geschrieben, in die FileList.txtein Wagenrücklauf zwischen den einzelnen Dateien eingefügt wird, um eine bessere Lesbarkeit zu erhalten.
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. Verwenden Sie zum Angeben einer anderen Codierung eine andere Überladung der WriteAllText Methode.
Wenn die angegebene Datei nicht vorhanden ist, wird sie erstellt.
Wenn die angegebene Codierung nicht mit der vorhandenen Codierung der Datei übereinstimmt, wird die angegebene Codierung ignoriert.
Note
Die WriteAllText Methode öffnet eine Datei, schreibt sie, und schließt sie. Code, der die WriteAllText Methode verwendet, ist einfacher als Code, der ein StreamWriter Objekt verwendet. Wenn Sie einer Datei jedoch Zeichenfolgen mithilfe einer Schleife 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 in der OpenTextFileWriter Methode.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.WriteAllText Methode betreffen.
| To | Siehe |
|---|---|
| Schreiben von Text in eine Datei | Anleitung: Text in Dateien schreiben |
| Anfügen von Text an eine Datei | Vorgehensweise: An Textdateien anfügen |
Weitere Informationen
- Encoding
- WriteAllText(String, String, Boolean)
- Objekte (Visual Basic)
- Schreiben in Dateien in Visual Basic
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 -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)Parameter
- file
- String
Datei, in die geschrieben werden soll.
- text
- String
Text, der in die Datei geschrieben werden soll.
- append
- Boolean
True an den Inhalt der Datei anzufügen; False um den Inhalt der Datei zu überschreiben. Der Standardwert ist False.
- encoding
- Encoding
Welche Codierung beim Schreiben in die Datei verwendet werden soll. Der Standardwert ist UTF-8.
Ausnahmen
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen 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 vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Es ist nicht genügend Arbeitsspeicher vorhanden, um die Zeichenfolge in puffern zu schreiben.
Der Benutzer verfügt nicht über erforderliche 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 den Ordner geschrieben, in die FileList.txtein Wagenrücklauf zwischen den einzelnen Dateien eingefügt wird, um eine bessere Lesbarkeit zu erhalten.
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
Wenn die angegebene Datei nicht vorhanden ist, wird sie erstellt.
Wenn die angegebene Codierung nicht mit der vorhandenen Codierung der Datei übereinstimmt, wird die angegebene Codierung ignoriert.
Note
Die WriteAllText Methode öffnet eine Datei, schreibt sie, und schließt sie. Code, der die WriteAllText Methode verwendet, ist einfacher als Code, der ein StreamWriter Objekt verwendet. Wenn Sie einer Datei jedoch Zeichenfolgen mithilfe einer Schleife 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 in der OpenTextFileWriter Methode.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.WriteAllText Methode betreffen.
| To | Siehe |
|---|---|
| Schreiben von Text in eine Datei | Anleitung: Text in Dateien schreiben |
| Anfügen von Text an eine Datei | Vorgehensweise: An Textdateien anfügen |