File.ReadAllText Methode

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.FileSystem.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.IO.FileSystem.dll

Assemblys:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 in der Datei in eine Zeichenfolge und schließt dann die Datei.

Überlädt

Name	Beschreibung
ReadAllText(String)	Öffnet eine Textdatei, liest den gesamten Text in der Datei und schließt dann die Datei.
ReadAllText(String, Encoding)	Öffnet eine Datei, liest den gesamten Text in der Datei mit der angegebenen Codierung und schließt dann die Datei.

ReadAllText(String)

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Öffnet eine Textdatei, liest den gesamten Text in 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

String

Eine Zeichenfolge, die den gesamten Text in der Datei enthält.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: path eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

- oder -

path ein Verzeichnis angegeben.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

FileNotFoundException

Die angegebene path Datei wurde nicht gefunden.

NotSupportedException

path ist in einem ungültigen Format vorhanden.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ReadAllText Methode zum Anzeigen des Inhalts einer Datei veranschaulicht. 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 sie als Zeichenfolge zurück. Anschließend wird die Datei geschlossen.

Diese Methode versucht, die Codierung einer Datei basierend auf dem Vorhandensein von Bytereihenfolgezeichen 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 Bytereihenfolgenzeichen beginnt.

Verwenden Sie die ReadAllText(String, Encoding) Methodenüberladung beim Lesen von Dateien, die importierten Text enthalten können, da nicht erkannte Zeichen möglicherweise nicht richtig gelesen werden.

Das Dateihandle wird durch diese Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.

Weitere Informationen

Gilt für:

ReadAllText(String, Encoding)

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Öffnet eine Datei, liest den gesamten Text in 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

String

Eine Zeichenfolge, die den gesamten Text in der Datei enthält.

Ausnahmen

ArgumentException

ArgumentNullException

path ist null.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

- oder -

path ein Verzeichnis angegeben.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

FileNotFoundException

Die angegebene path Datei wurde nicht gefunden.

NotSupportedException

path ist in einem ungültigen Format vorhanden.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

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 sie als Zeichenfolge zurück. Anschließend wird die Datei geschlossen.

Das Dateihandle wird durch diese Methode garantiert geschlossen, auch wenn Ausnahmen ausgelöst werden.

Wenn Sie die Codierungseinstellungen wie für Ihr Betriebssystem konfiguriert verwenden möchten, geben Sie die Encoding.Default Eigenschaft für den encoding Parameter an.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

File.ReadAllText Methode

Definition

Überlädt

ReadAllText(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ReadAllText(String, Encoding)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback