FileSystem.ReadAllText Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Gibt den Inhalt einer Textdatei als String zurück.

Überlädt

ReadAllText(String)	Gibt den Inhalt einer Textdatei als String zurück.
ReadAllText(String, Encoding)	Gibt den Inhalt einer Textdatei als String zurück.

ReadAllText(String)

Quelle:

FileSystem.vb

Gibt den Inhalt einer Textdatei als String zurück.

public:
 static System::String ^ ReadAllText(System::String ^ file);

public static string ReadAllText (string file);

static member ReadAllText : string -> string

Public Shared Function ReadAllText (file As String) As String

Parameter

file

String

Name und Pfad der zu lesenden Datei.

Gibt zurück

String

Ein String mit dem Inhalt der Datei.

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 der Inhalt von Test.txt in eine 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

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

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.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.ReadAllText -Methode umfasst.

Beschreibung	Siehe
Lesen aus einer Textdatei	Gewusst wie: Lesen von Textdateien in Visual Basic

Weitere Informationen

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Quelle:

FileSystem.vb

Gibt den Inhalt einer Textdatei als String zurück.

public:
 static System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);

public static string ReadAllText (string file, System.Text.Encoding encoding);

static member ReadAllText : string * System.Text.Encoding -> string

Public Shared Function ReadAllText (file As String, encoding As Encoding) As String

Parameter

file

String

Name und Pfad der zu lesenden Datei.

encoding

Encoding

Die Zeichencodierung, die beim Lesen der Datei verwendet werden soll. Der Standardwert ist UTF-8.

Gibt zurück

String

Ein String mit dem Inhalt der Datei.

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 der Inhalt von Test.txt in eine 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

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

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.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.ReadAllText -Methode umfasst.

Beschreibung	Siehe
Lesen aus einer Textdatei	Gewusst wie: Lesen von Textdateien in Visual Basic

Weitere Informationen

• Encoding
• StreamReader(Stream, Encoding)