FileSystemProxy.ReadAllText Methode

Definition

Namespace:
Microsoft.VisualBasic.MyServices
Assembly:
Microsoft.VisualBasic.dll

Gibt den Inhalt einer Textdatei als ein String.

Überlädt

Name Beschreibung
ReadAllText(String)

Gibt den Inhalt einer Textdatei als ein String.
ReadAllText(String, Encoding)

Gibt den Inhalt einer Textdatei als ein String.

ReadAllText(String)

Gibt den Inhalt einer Textdatei als ein String.

public:
 System::String ^ ReadAllText(System::String ^ file);
public string ReadAllText(string file);
member this.ReadAllText : string -> string
Public Function ReadAllText (file As String) As String

Parameter

file
String

Name und Pfad der zu lesenden Datei.

Gibt zurück

String

String enthält den Inhalt der Datei.

Ausnahmen

ArgumentException

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.

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 vom System definierte maximale Länge.

NotSupportedException

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

OutOfMemoryException

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

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.

Beispiele

In diesem Beispiel wird der Inhalt Test.txt einer Zeichenfolge gelesen und dann in einem Meldungsfeld angezeigt.

Dim 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 dann in einem Meldungsfeld angezeigt.

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

Hinweise

Mit ReadAllText der Methode des My.Computer.FileSystem Objekts können Sie aus einer Textdatei lesen. Der Inhalt der Datei wird als Zeichenfolge zurückgegeben.

Die Dateicodierung kann angegeben werden, wenn sich der Inhalt der Datei in einer Codierung wie ASCII oder UTF-8 befindet. Wenn Sie aus einer Datei mit erweiterten Zeichen lesen, müssen Sie die Dateicodierung mithilfe einer anderen Überladung der ReadAllText Methode angeben.

Treffen Sie keine Entscheidungen über den Inhalt der Datei basierend auf dem Namen der Datei. Beispielsweise ist die Datei Form1.vb möglicherweise keine Visual Basic-Quelldatei. Überprüfen Sie alle Eingaben, bevor Sie die Daten in Ihrer Anwendung verwenden.

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

To Siehe
Lesen aus einer Textdatei Vorgehensweise: Lesen aus Textdateien

Weitere Informationen

Gilt für:

ReadAllText(String, Encoding)

Gibt den Inhalt einer Textdatei als ein String.

public:
 System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);
public string ReadAllText(string file, System.Text.Encoding encoding);
member this.ReadAllText : string * System.Text.Encoding -> string
Public Function ReadAllText (file As String, encoding As Encoding) As String

Parameter

file
String

Name und Pfad der zu lesenden Datei.

encoding
Encoding

Zeichencodierung zum Lesen der Datei. Der Standardwert ist UTF-8.

Gibt zurück

String

String enthält den Inhalt der Datei.

Ausnahmen

ArgumentException

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.

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 vom System definierte maximale Länge.

NotSupportedException

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

OutOfMemoryException

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

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.

Beispiele

In diesem Beispiel wird der Inhalt Test.txt einer Zeichenfolge gelesen und dann in einem Meldungsfeld angezeigt.

Dim 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 dann in einem Meldungsfeld angezeigt.

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

Hinweise

Mit ReadAllText der Methode des My.Computer.FileSystem Objekts können Sie aus einer Textdatei lesen. Der Inhalt der Datei wird als Zeichenfolge zurückgegeben.

Die Dateicodierung kann angegeben werden, wenn sich der Inhalt der Datei in einer Codierung wie ASCII oder UTF-8 befindet. Wenn Sie aus einer Datei mit erweiterten Zeichen lesen, müssen Sie die Dateicodierung angeben.

Treffen Sie keine Entscheidungen über den Inhalt der Datei basierend auf dem Namen der Datei. Beispielsweise ist die Datei Form1.vb möglicherweise keine Visual Basic-Quelldatei. Überprüfen Sie alle Eingaben, bevor Sie die Daten in Ihrer Anwendung verwenden.

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

To Siehe
Lesen aus einer Textdatei Vorgehensweise: Lesen aus Textdateien

Weitere Informationen

Gilt für: