My.Computer.FileSystem.ReadAllText-Methode

Aktualisiert: November 2007

Gibt den Inhalt einer Textdatei als String zurück.

' Usage
Dim value As String = My.Computer.FileSystem.ReadAllText(file)
Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding)
' Declaration
Public Function ReadAllText( _
   ByVal file As String _
) As String
' -or-
Public Function ReadAllText( _
   ByVal file As String, _
   ByVal encoding As System.Text.Encoding _
) As String

Parameter

• file
  String. Name und Pfad der zu lesenden Datei. Erforderlich.

• encoding
  System.Text.Encoding. Die beim Lesen der Datei zu verwendende Zeichencodierung. Erforderlich. Der Standardwert ist UTF-8.

Rückgabewert

String mit dem Inhalt der Datei.

Ausnahmen

Die Datei kann andere Inhalte als erwartet enthalten. Die Methoden zum Lesen aus der Datei können fehlschlagen.

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, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).

• Der Dateiname endet mit einem nachgestellten Schrägstrich (ArgumentException).

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

• Die Datei ist nicht vorhanden (FileNotFoundException).

• 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).

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

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

Hinweise

Die ReadAllText-Methode des My.Computer.FileSystem-Objekts ermöglicht das Lesen aus einer Textdatei. Der Inhalt der Datei wird als Zeichenfolge zurückgegeben.

Die Dateicodierung kann angegeben werden, wenn die Inhaltscodierung der Datei z. B. ASCII oder UTF-8 ist. Zum Lesen aus einer Datei mit erweiterten Zeichen müssen Sie die Dateicodierung angeben.

Beurteilen Sie den Inhalt der Datei nicht anhand des Dateinamens. Bei der Datei Form1.vb handelt es sich zum Beispiel nicht unbedingt um eine Visual Basic-Quelldatei. Überprüfen Sie alle Eingaben, bevor Sie die Daten in der Anwendung verwenden.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.ReadAllText-Methode aufgeführt.

Beispiel

In diesem Beispiel wird der Inhalt von Test.txt in eine Zeichenfolge gelesen und anschließend in einem Meldungsfeld angezeigt.

Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

In diesem Beispiel wird der Inhalt der ASCII-Datei Test.txt in eine Zeichenfolge gelesen und anschließend in einem Meldungsfeld angezeigt.

Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt", _
   System.Text.Encoding.ASCII)
MsgBox(reader)

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

Aufgaben

Gewusst wie: Lesen von Text aus Dateien mit einem StreamReader (Visual Basic)

Problembehandlung: Lesen aus und Schreiben in Textdateien

Exemplarische Vorgehensweise: Bearbeiten von Dateien und Verzeichnissen in Visual Basic

Konzepte

Dateicodierungen

Referenz

My.Computer.FileSystem-Objekt

System.Text.Encoding

FileSystem.ReadAllText

StreamReader

Weitere Ressourcen

Lesen aus Dateien in Visual Basic