File.ReadAllText Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Öffnet eine Textdatei, liest den gesamten Text der Datei in eine Zeichenfolge ein und schließt dann die Datei.
Überlädt
ReadAllText(String) |
Öffnet eine Textdatei, liest den gesamten Text der Datei und schließt dann die Datei. |
ReadAllText(String, Encoding) |
Öffnet eine Datei, liest den gesamten Text der Datei mit der angegebenen Codierung und schließt dann die Datei. |
ReadAllText(String)
- Quelle:
- File.cs
- Quelle:
- File.cs
- Quelle:
- File.cs
Öffnet eine Textdatei, liest den gesamten Text der Datei und schließt dann die Datei.
public:
static System::String ^ ReadAllText(System::String ^ path);
public static string ReadAllText (string path);
static member ReadAllText : string -> string
Public Shared Function ReadAllText (path As String) As String
Parameter
- path
- String
Die Datei, die zum Lesen geöffnet werden soll.
Gibt zurück
Eine Zeichenfolge, die den gesamten Text der Datei enthält.
Ausnahmen
.NET Framework- und .NET Core-Versionen älter als 2.1: path
ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.
path
ist null
.
Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
path
hat eine schreibgeschützte Datei angegeben.
- oder -
Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.
- oder -
path
hat ein Verzeichnis angegeben.
- oder -
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Die in path
angegebene Datei wurde nicht gefunden.
path
weist ein ungültiges Format auf.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der ReadAllText -Methode veranschaulicht, um den Inhalt einer Datei anzuzeigen. In diesem Beispiel wird eine Datei erstellt, sofern sie noch nicht vorhanden ist, und ihr Text hinzugefügt.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
// This text is added only once to the file.
if (!File.Exists(path))
{
// Create a file to write to.
string createText = "Hello and Welcome" + Environment.NewLine;
File.WriteAllText(path, createText);
}
// This text is always added, making the file longer over time
// if it is not deleted.
string appendText = "This is extra text" + Environment.NewLine;
File.AppendAllText(path, appendText);
// Open the file to read from.
string readText = File.ReadAllText(path);
Console.WriteLine(readText);
}
}
open System
open System.IO
let path = @"c:\temp\MyTest.txt"
// This text is added only once to the file.
if File.Exists path |> not then
// Create a file to write to.
let createText =
"Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText)
// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
"This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText)
// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
' This text is added only once to the file.
If File.Exists(path) = False Then
' Create a file to write to.
Dim createText As String = "Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText)
End If
' This text is always added, making the file longer over time
' if it is not deleted.
Dim appendText As String = "This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText)
' Open the file to read from.
Dim readText As String = File.ReadAllText(path)
Console.WriteLine(readText)
End Sub
End Class
Hinweise
Diese Methode öffnet eine Datei, liest den gesamten Text in der Datei und gibt ihn als Zeichenfolge zurück. Anschließend wird die Datei geschlossen.
Diese Methode versucht, die Codierung einer Datei basierend auf dem Vorhandensein von Bytereihenfolgemarken automatisch zu erkennen. Es erkennt automatisch UTF-8-, little-endian UTF-16-, big-endian UTF-16-, little-endian UTF-32- und big-endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgen beginnt.
Verwenden Sie die ReadAllText(String, Encoding) Methodenüberladung beim Lesen von Dateien, die möglicherweise importierten Text enthalten, da nicht erkannte Zeichen möglicherweise nicht ordnungsgemäß gelesen werden.
Das Dateihandle wird von dieser Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.
Weitere Informationen
- Datei- und Stream-E/A
- Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
- How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Gilt für:
ReadAllText(String, Encoding)
- Quelle:
- File.cs
- Quelle:
- File.cs
- Quelle:
- File.cs
Öffnet eine Datei, liest den gesamten Text der Datei mit der angegebenen Codierung und schließt dann die Datei.
public:
static System::String ^ ReadAllText(System::String ^ path, System::Text::Encoding ^ encoding);
public static string ReadAllText (string path, System.Text.Encoding encoding);
static member ReadAllText : string * System.Text.Encoding -> string
Public Shared Function ReadAllText (path As String, encoding As Encoding) As String
Parameter
- path
- String
Die Datei, die zum Lesen geöffnet werden soll.
- encoding
- Encoding
Die auf den Inhalt der Datei angewendete Codierung.
Gibt zurück
Eine Zeichenfolge, die den gesamten Text der Datei enthält.
Ausnahmen
.NET Framework- und .NET Core-Versionen älter als 2.1: path
ist eine Zeichenfolge der Länge null, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können Abfragen für ungültige Zeichen mithilfe der GetInvalidPathChars()-Methode ausführen.
path
ist null
.
Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.
Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).
Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.
path
hat eine schreibgeschützte Datei angegeben.
- oder -
Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.
- oder -
path
hat ein Verzeichnis angegeben.
- oder -
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Die in path
angegebene Datei wurde nicht gefunden.
path
weist ein ungültiges Format auf.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der ReadAllText -Methode veranschaulicht, um den Inhalt einer Datei anzuzeigen. In diesem Beispiel wird eine Datei erstellt, sofern sie noch nicht vorhanden ist, und ihr Text hinzugefügt.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
// This text is added only once to the file.
if (!File.Exists(path))
{
// Create a file to write to.
string createText = "Hello and Welcome" + Environment.NewLine;
File.WriteAllText(path, createText, Encoding.UTF8);
}
// This text is always added, making the file longer over time
// if it is not deleted.
string appendText = "This is extra text" + Environment.NewLine;
File.AppendAllText(path, appendText, Encoding.UTF8);
// Open the file to read from.
string readText = File.ReadAllText(path);
Console.WriteLine(readText);
}
}
open System
open System.IO
open System.Text
let path = @"c:\temp\MyTest.txt"
// This text is added only once to the file.
if File.Exists path |> not then
// Create a file to write to.
let createText =
"Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText, Encoding.UTF8)
// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
"This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText, Encoding.UTF8)
// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
Dim sw As StreamWriter
' This text is added only once to the file.
If File.Exists(path) = False Then
' Create a file to write to.
Dim createText As String = "Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText, Encoding.UTF8)
End If
' This text is always added, making the file longer over time
' if it is not deleted.
Dim appendText As String = "This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText, Encoding.UTF8)
' Open the file to read from.
Dim readText As String = File.ReadAllText(path)
Console.WriteLine(readText)
End Sub
End Class
Hinweise
Diese Methode öffnet eine Datei, liest den gesamten Text in der Datei und gibt ihn als Zeichenfolge zurück. Anschließend wird die Datei geschlossen.
Diese Methode versucht, die Codierung einer Datei basierend auf dem Vorhandensein von Bytereihenfolgemarken automatisch zu erkennen. Es erkennt automatisch UTF-8-, little-endian UTF-16-, big-endian UTF-16-, little-endian UTF-32- und big-endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgen beginnt.
Das Dateihandle wird von dieser Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.
Um die Codierungseinstellungen wie für Ihr Betriebssystem konfiguriert zu verwenden, geben Sie die Encoding.Default -Eigenschaft für den Parameter an encoding
.
Weitere Informationen
- Datei- und Stream-E/A
- Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
- How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei