File.ReadAllText File.ReadAllText File.ReadAllText File.ReadAllText Method

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) ReadAllText(String, Encoding) 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) ReadAllText(String) ReadAllText(String) 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) ReadAllText(String, Encoding) 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 String String String

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

encoding
Encoding Encoding 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 Zeichenfolge der Länge 0 (null), besteht nur aus Leerzeichen oder enthält mindestens eines der von InvalidPathChars definierten ungültigen Zeichen.is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

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.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.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.is in an invalid format.

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

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung von der ReadAllText Methode, 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 dieser nicht bereits vorhanden ist, und Text wird hinzugefügt.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
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, die gesamte Text in der Datei liest und wird als Zeichenfolge zurückgegeben.This method opens a file, reads all the text in the file, and returns it as a string. Es schließt dann die Datei.It then closes the file.

Diese Methode versucht, automatisch zu erkennen, die Codierung einer Datei, die basierend auf dem Vorhandensein der Bytereihenfolge-Marken.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Codierung Formate UTF-8 und UTF-32 (big-Endian- und einer little-Endian) erkannt werden kann.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

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

Um die codierungseinstellungen verwenden wie für Ihr Betriebssystem konfiguriert, geben die Encoding.Default -Eigenschaft für die encoding Parameter.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 eines Verzeichnisses.for access to read from a file or directory. Zugeordnete Enumeration:Associated enumeration: Read

Siehe auch

ReadAllText(String) ReadAllText(String) ReadAllText(String) 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 String String 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 Zeichenfolge der Länge 0 (null), besteht nur aus Leerzeichen oder enthält mindestens eines der von InvalidPathChars definierten ungültigen Zeichen.is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

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.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.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.is in an invalid format.

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

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung von der ReadAllText Methode, 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 dieser nicht bereits vorhanden ist, und Text wird hinzugefügt.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
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, die gesamte Text in der Datei liest und wird als Zeichenfolge zurückgegeben.This method opens a file, reads all the text in the file, and returns it as a string. Es schließt dann die Datei.It then closes the file.

Diese Methode versucht, automatisch zu erkennen, die Codierung einer Datei, die basierend auf dem Vorhandensein der Bytereihenfolge-Marken.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Codierung Formate UTF-8 und UTF-32 (big-Endian- und einer little-Endian) erkannt werden kann.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Verwenden der ReadAllText(String, Encoding) -methodenüberladung beim Lesen von Dateien, die importierte Text enthalten, können da Zeichen nicht erkannte nicht korrekt gelesen werden kann.Use the ReadAllText(String, Encoding) method overload when reading files that might contain imported text, because unrecognized characters may not be read correctly.

Das Dateihandle ist garantiert, von dieser Methode geschlossen werden, selbst 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 eines Verzeichnisses.for access to read from a file or directory. Zugeordnete Enumeration:Associated enumeration: Read

Siehe auch

Gilt für: