My.Computer.FileSystem.WriteAllText-Methode

Aktualisiert: November 2007

Schreibt Text in eine Datei.

' Usage
My.Computer.FileSystem.WriteAllText(file ,text ,append)
My.Computer.FileSystem.WriteAllText(file ,text ,append ,encoding)
' Declaration
Public Sub WriteAllText( _
   ByVal file As String, _
   ByVal text As String, _
   ByVal append As Boolean _
)
' -or-
Public Sub WriteAllText( _
   ByVal file As String, _
   ByVal text As String, _
   ByVal append As Boolean, _
   ByVal encoding As System.Text.Encoding _
)

Parameter

• file
  String. Datei, in die geschrieben werden soll. Erforderlich.

• text
  String. Text, der in die Datei geschrieben werden soll. Erforderlich.

• append
  Boolean. Ob Text angefügt oder vorhandener Text überschrieben werden soll. Der Standardwert ist False. Erforderlich.

• encoding
  Encoding. Codierung, mit der in die Datei geschrieben werden soll. Erforderlich. Die Standardeinstellung ist UTF-8.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

• Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, er endet mit einem nachgestellten Schrägstrich, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).

• Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).

• file zeigt auf einen Pfad, der nicht vorhanden ist (FileNotFoundException oder DirectoryNotFoundException).

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

• Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).

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

• Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).

Bei Ausführung in einer teilweise vertrauenswürdigen Umgebung kann der Code aufgrund fehlender Berechtigungen eine Ausnahme auslösen. Weitere Informationen finden Sie unter Grundlagen der Codezugriffssicherheit.

Hinweise

Wenn keine Codierung angegeben wurde, wird UTF-8 verwendet. Die Byte-Reihenfolgemarkierung für die Codierung wird in die Datei geschrieben, sofern Sie nicht Encoding.Default angeben, wobei die aktuelle ANSI-Codepage des Systems verwendet wird. Wenn die angegebene Codierung nicht mit der vorhandenen Codierung der Datei übereinstimmt, wird die angegebene Codierung ignoriert.

Wenn der angegebene Pfad (ohne den Dateinamen) ungültig ist, wird eine DirectoryNotFoundException-Ausnahme ausgelöst. Wenn der Pfad gültig ist, die Datei jedoch nicht vorhanden ist, wird die Datei erstellt.

Wenn der append-Parameter den Wert True hat, wird der Text durch die Methode an die Datei angefügt. Andernfalls wird der in der Datei vorhandene Text überschrieben.

Hinweis:

Mit der WriteAllText-Methode wird eine Datei geöffnet, in die Datei geschrieben und die Datei anschließend geschlossen. Code, der die WriteAllText-Methode verwendet, ist einfacher als Code, der ein StreamWriter-Objekt verwendet. Wenn Sie jedoch mithilfe einer Schleife Zeichenfolgen zu einer Datei hinzufügen, kann ein StreamWriter-Objekt die höhere Leistung bieten, da die Datei nur einmal geöffnet und geschlossen werden muss. Weitere Informationen finden Sie unter My.Computer.FileSystem.OpenTextFileWriter-Methode.

Aufgaben

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

Beispiel

In diesem Beispiel wird die Zeile "This is new text to be added." in die Datei Test.txt geschrieben und in der Datei vorhandener Text ggf. überschrieben.

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 Ordner Documents and Settings in FileList.txt geschrieben und zwischen jeder Datei ein Wagenrücklauf eingefügt, um die Lesbarkeit zu verbessern.

For Each foundFile As String 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

Anforderungen

Namespace:Microsoft.VisualBasic.MyServices

Klasse:FileSystemProxy (ermöglicht den Zugriff auf FileSystem)

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Referenz

My.Computer.FileSystem-Objekt

System.Text.Encoding

FileSystem.WriteAllText

My.Computer.FileSystem.OpenTextFileWriter-Methode

Weitere Ressourcen

Schreiben in Dateien in Visual Basic