FileSystem.WriteAllText Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

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)

Quelle:

FileSystem.vb

Schreibt Text in eine Datei.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public static void WriteAllText (string file, string text, bool append);

static member WriteAllText : string * string * bool -> unit

Public Shared 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.

Ausnahmen

ArgumentException

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.

ArgumentNullException

file ist Nothing.

FileNotFoundException

Die Datei ist nicht vorhanden.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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	Gewusst wie: Schreiben von Text in Dateien in Visual Basic
Anfügen von Text an eine Datei	Gewusst wie: Anfügen an Textdateien in Visual Basic

Weitere Informationen

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Quelle:

FileSystem.vb

Schreibt Text in eine Datei.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

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

Public Shared 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.

encoding

Encoding

Die beim Schreiben in die Datei zu verwendende Codierung.

Ausnahmen

ArgumentException

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.

ArgumentNullException

file ist Nothing.

FileNotFoundException

Die Datei ist nicht vorhanden.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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	Gewusst wie: Schreiben von Text in Dateien in Visual Basic
Anfügen von Text an eine Datei	Gewusst wie: Anfügen an Textdateien in Visual Basic

Weitere Informationen

• Encoding