File.ReadAllLines File.ReadAllLines File.ReadAllLines File.ReadAllLines Method

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

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

Das folgende Codebeispiel veranschaulicht die Verwendung von der ReadAllLines Methode, 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 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;
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
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

Diese Methode öffnet eine Datei, liest alle Zeilen der Datei und fügt dann jede Zeile als ein Element eines Zeichenfolgenarrays.This method opens a file, reads each line of the file, then adds each line as an element of a string array. Es schließt dann die Datei.It then closes the file. Eine ist definiert als eine Folge von Zeichen, gefolgt von einem Wagenrücklauf (\r), einem Zeilenvorschub ('\n'), oder ein Wagenrücklaufzeichen gefolgt direkt von einer Zeile Zeilenvorschub.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 die abschließende Carriage return, Wagenrücklauf und/oder Zeilenvorschub.The resulting string does not contain the terminating carriage return and/or line feed.

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.

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: Read Associated enumeration: Read

Siehe auch

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

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

Das folgende Codebeispiel veranschaulicht die Verwendung von der ReadAllLines Methode, 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 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" };
            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
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

Diese Methode öffnet eine Datei, liest jeder Zeile der Datei und fügt jeder Zeile als ein Element von einem Zeichenfolgen-Array.This method opens a file, reads each line of the file, and then adds each line as an element of a string array. Es schließt dann die Datei.It then closes the file. Eine ist definiert als eine Folge von Zeichen, gefolgt von einem Wagenrücklauf (\r), einem Zeilenvorschub ('\n'), oder ein Wagenrücklaufzeichen gefolgt direkt von einer Zeile Zeilenvorschub.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 die abschließende Carriage return, Wagenrücklauf und/oder Zeilenvorschub.The resulting string does not contain the terminating carriage return and/or line feed.

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.

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: Read Associated enumeration: Read

Siehe auch

Gilt für: