File.ReadAllText Methode

Definition

Öffnet eine Textdatei, liest den gesamten Text der Datei in eine Zeichenfolge ein und schließt dann die Datei.Opens a text file, reads all the text in the file into a string, and then closes the file.

Überlädt

ReadAllText(String, Encoding)

Öffnet eine Datei, liest den gesamten Text der Datei mit der angegebenen Codierung und schließt dann die Datei.Opens a file, reads all text in the file with the specified encoding, and then closes the file.

ReadAllText(String)

Öffnet eine Textdatei, liest den gesamten Text der Datei und schließt dann die Datei.Opens a text file, reads all the text in the file, and then closes the file.

ReadAllText(String, Encoding)

Öffnet eine Datei, liest den gesamten Text der Datei mit der angegebenen Codierung und schließt dann die Datei.Opens a file, reads all text in the file with the specified encoding, and then closes the file.

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

Parameter

path
String

Die Datei, die zum Lesen geöffnet werden soll.The file to open for reading.

encoding
Encoding

Die auf den Inhalt der Datei angewendete Codierung.The encoding applied to the contents of the file.

Gibt zurück

Eine Zeichenfolge, die den gesamten Text der Datei enthält.A string containing all text in the file.

Ausnahmen

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path ist null.path is null.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.An I/O error occurred while opening the file.

path hat eine schreibgeschützte Datei angegeben.path specified a file that is read-only.

- oder --or- Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.This operation is not supported on the current platform.

- oder --or- path hat ein Verzeichnis angegeben.path specified a directory.

- oder --or- Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Die in path angegebene Datei wurde nicht gefunden.The file specified in path was not found.

path weist ein ungültiges Format auf.path is in an invalid format.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ReadAllText-Methode verwendet wird, um den Inhalt einer Datei anzuzeigen.The following code example demonstrates the use of the ReadAllText method to display the contents of a file. In diesem Beispiel wird eine Datei erstellt, wenn Sie nicht bereits vorhanden ist und Text hinzugefügt wird.In this example a file is created, if it doesn't already exist, and text is added to it.

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);
    }
}
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.This method opens a file, reads all the text in the file, and returns it as a string. Anschließend wird die Datei geschlossen.It then closes the file.

Diese Methode versucht, die Codierung einer Datei automatisch basierend auf dem vorhanden sein von Byte Reihenfolge Markierungen zu erkennen.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Die Codierungs Formate UTF-8 und UTF-32 (sowohl Big-als auch Little-enddian) können erkannt werden.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Das Datei Handle wird garantiert von dieser Methode geschlossen, auch wenn Ausnahmen ausgelöst werden.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Um die für das Betriebssystem konfigurierten Codierungs Einstellungen zu verwenden, geben Sie die Encoding.Default-Eigenschaft für den encoding-Parameter an.To use the encoding settings as configured for your operating system, specify the Encoding.Default property for the encoding parameter.

Sicherheit

FileIOPermission
für den Zugriff zum Lesen aus einer Datei oder einem Verzeichnis.for access to read from a file or directory. Zugehörige Enumeration: ReadAssociated enumeration: Read

Siehe auch

ReadAllText(String)

Öffnet eine Textdatei, liest den gesamten Text der Datei und schließt dann die Datei.Opens a text file, reads all the text in the file, and then closes the file.

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.The file to open for reading.

Gibt zurück

Eine Zeichenfolge, die den gesamten Text der Datei enthält.A string containing all the text in the file.

Ausnahmen

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path ist null.path is null.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.An I/O error occurred while opening the file.

path hat eine schreibgeschützte Datei angegeben.path specified a file that is read-only.

- oder --or- Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.This operation is not supported on the current platform.

- oder --or- path hat ein Verzeichnis angegeben.path specified a directory.

- oder --or- Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Die in path angegebene Datei wurde nicht gefunden.The file specified in path was not found.

path weist ein ungültiges Format auf.path is in an invalid format.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ReadAllText-Methode verwendet wird, um den Inhalt einer Datei anzuzeigen.The following code example demonstrates the use of the ReadAllText method to display the contents of a file. In diesem Beispiel wird eine Datei erstellt, wenn Sie nicht bereits vorhanden ist und Text hinzugefügt wird.In this example a file is created, if it doesn't already exist, and text is added to it.

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);
    }
}
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.This method opens a file, reads all the text in the file, and returns it as a string. Anschließend wird die Datei geschlossen.It then closes the file.

Diese Methode versucht, die Codierung einer Datei automatisch basierend auf dem vorhanden sein von Byte Reihenfolge Markierungen zu erkennen.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Die Codierungs Formate UTF-8 und UTF-32 (sowohl Big-als auch Little-enddian) können erkannt werden.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Verwenden Sie die ReadAllText(String, Encoding)-Methoden Überladung beim Lesen von Dateien, die möglicherweise importierten Text enthalten, da unbekannte Zeichen möglicherweise nicht ordnungsgemäß gelesen werden.Use the ReadAllText(String, Encoding) method overload when reading files that might contain imported text, because unrecognized characters may not be read correctly.

Das Datei Handle wird garantiert von dieser Methode geschlossen, auch wenn Ausnahmen ausgelöst werden.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Sicherheit

FileIOPermission
für den Zugriff zum Lesen aus einer Datei oder einem Verzeichnis.for access to read from a file or directory. Zugehörige Enumeration: ReadAssociated enumeration: Read

Siehe auch

Gilt für: