File.ReadAllLines Methode

Definition

Öffnet eine Textdatei, liest alle Zeilen der Datei in ein Zeichenfolgenarray ein und schließt dann die Datei.Opens a text file, reads all lines of the file into a string array, and then closes the file.

Überlädt

ReadAllLines(String)

Öffnet eine Textdatei, liest alle Zeilen der Datei und schließt dann die Datei.Opens a text file, reads all lines of the file, and then closes the file.

ReadAllLines(String, Encoding)

Öffnet eine Datei, liest alle Zeilen der Datei mit der angegebenen Codierung und schließt dann die Datei.Opens a file, reads all lines of the file with the specified encoding, and then closes the file.

ReadAllLines(String)

Öffnet eine Textdatei, liest alle Zeilen der Datei und schließt dann die Datei.Opens a text file, reads all lines of the file, and then closes the file.

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path);
public static string[] ReadAllLines (string path);
static member ReadAllLines : string -> string[]
Public Shared Function ReadAllLines (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

String[]

Ein Zeichenfolgenarray, das alle Zeilen der Datei enthält.A string array containing all lines of 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 ReadAllLines-Methode verwendet wird, um den Inhalt einer Datei anzuzeigen.The following code example demonstrates the use of the ReadAllLines 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;
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" };
            File.WriteAllLines(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.ReadAllLines(path);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}
Imports System.IO

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"}
            File.WriteAllLines(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.ReadAllLines(path)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Hinweise

Mit dieser Methode wird eine Datei geöffnet, jede Zeile der Datei gelesen und dann jede Zeile als Element eines Zeichen folgen Arrays hinzugefügt.This method opens a file, reads each line of the file, then adds each line as an element of a string array. Anschließend wird die Datei geschlossen.It then closes the file. Eine Zeile wird als Sequenz von Zeichen, gefolgt von einem Wagen Rücklauf Zeichen ("\r"), einem Zeilenvorschub ("\n") oder einem Wagen Rücklauf unmittelbar gefolgt von einem Zeilenvorschub definiert.A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. Die resultierende Zeichenfolge enthält nicht den abschließenden Wagen Rücklauf und/oder Zeilenvorschub.The resulting string does not contain the terminating carriage return and/or line feed.

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.

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

ReadAllLines(String, Encoding)

Öffnet eine Datei, liest alle Zeilen der Datei mit der angegebenen Codierung und schließt dann die Datei.Opens a file, reads all lines of the file with the specified encoding, and then closes the file.

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path, System::Text::Encoding ^ encoding);
public static string[] ReadAllLines (string path, System.Text.Encoding encoding);
static member ReadAllLines : 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

String[]

Ein Zeichenfolgenarray, das alle Zeilen der Datei enthält.A string array containing all lines of 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 ReadAllLines-Methode verwendet wird, um den Inhalt einer Datei anzuzeigen.The following code example demonstrates the use of the ReadAllLines 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" };
            File.WriteAllLines(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.ReadAllLines(path, Encoding.UTF8);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}
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"}
            File.WriteAllLines(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.ReadAllLines(path, Encoding.UTF8)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Hinweise

Mit dieser Methode wird eine Datei geöffnet, jede Zeile der Datei gelesen und dann jede Zeile als Element eines Zeichen folgen Arrays hinzugefügt.This method opens a file, reads each line of the file, and then adds each line as an element of a string array. Anschließend wird die Datei geschlossen.It then closes the file. Eine Zeile wird als Sequenz von Zeichen, gefolgt von einem Wagen Rücklauf Zeichen ("\r"), einem Zeilenvorschub ("\n") oder einem Wagen Rücklauf unmittelbar gefolgt von einem Zeilenvorschub definiert.A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. Die resultierende Zeichenfolge enthält nicht den abschließenden Wagen Rücklauf und/oder Zeilenvorschub.The resulting string does not contain the terminating carriage return and/or line feed.

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.

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: