File.ReadLines File.ReadLines File.ReadLines File.ReadLines Method

Definition

Liest die Zeilen einer Datei.Reads the lines of a file.

Überlädt

ReadLines(String) ReadLines(String) ReadLines(String) ReadLines(String)

Liest die Zeilen einer Datei.Reads the lines of a file.

ReadLines(String, Encoding) ReadLines(String, Encoding) ReadLines(String, Encoding)

Liest die Zeilen einer Datei mit einer angegebenen Codierung.Read the lines of a file that has a specified encoding.

ReadLines(String) ReadLines(String) ReadLines(String) ReadLines(String)

Liest die Zeilen einer Datei.Reads the lines of a file.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ ReadLines(System::String ^ path);
public static System.Collections.Generic.IEnumerable<string> ReadLines (string path);
static member ReadLines : string -> seq<string>
Public Shared Function ReadLines (path As String) As IEnumerable(Of String)

Parameter

path
String String String String

Die zu lesende Datei.The file to read.

Gibt zurück

Alle Zeilen der Datei oder die Zeilen, die das Ergebnis einer Abfrage sind.All the lines of the file, or the lines that are the result of a query.

Ausnahmen

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

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

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

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

path überschreitet die vom System definierte maximale Länge.path exceeds the system-defined maximum length.

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

path gibt eine schreibgeschützte Datei an.path specifies 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 ist ein Verzeichnis.path is a directory.

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

Beispiele

Im folgenden Beispiel werden die Zeilen einer Datei gelesen, um Zeilen zu suchen, die angegebene Zeichen folgen enthalten.The following example reads the lines of a file to find lines that contain specified strings.

foreach (string line in File.ReadLines(@"d:\data\episodes.txt"))
{
    if (line.Contains("episode") & line.Contains("2006"))
    {
        Console.WriteLine(line);
    }
}
For Each line As String In File.ReadLines("d:\data\episodes.txt")
    If line.Contains("episode") And line.Contains("2006") Then
        Console.WriteLine(line)
    End If
Next line

Im folgenden Beispiel wird die ReadLines -Methode in einer LINQ-Abfrage verwendet, die alle Verzeichnisse für Dateien auflistet, die über die Erweiterung. txt verfügen, jede Zeile der Datei liest und die Zeile anzeigt, wenn Sie die Zeichenfolge "Microsoft" enthält.The following example uses the ReadLines method in a LINQ query that enumerates all directories for files that have a .txt extension, reads each line of the file, and displays the line if it contains the string "Microsoft".

using System;
using System.IO;
using System.Linq;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            // Set a variable to the My Documents path.
            string docPath =
            Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

            var files = from file in Directory.EnumerateFiles(docPath, "*.txt", SearchOption.AllDirectories)
                        from line in File.ReadLines(file)
                        where line.Contains("Microsoft")
                        select new
                        {
                            File = file,
                            Line = line
                        };

            foreach (var f in files)
            {
                Console.WriteLine($"{f.File}\t{f.Line}");
            }
            Console.WriteLine($"{files.Count().ToString()} files found.");
        }
        catch (UnauthorizedAccessException uAEx)
        {
            Console.WriteLine(uAEx.Message);
        }
        catch (PathTooLongException pathEx)
        {
            Console.WriteLine(pathEx.Message);
        }
    }
}
Imports System.IO
Imports System.Xml.Linq

Module Module1

    Sub Main()
        Try
            Dim docPath As String = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
            Dim files = From chkFile In Directory.EnumerateFiles(docPath, "*.txt", SearchOption.AllDirectories)
                        From line In File.ReadLines(chkFile)
                        Where line.Contains("Microsoft")
                        Select New With {.curFile = chkFile, .curLine = line}

            For Each f In files
                Console.WriteLine($"{f.File}\t{f.Line}")
            Next
            Console.WriteLine($"{files.Count} files found.")
        Catch uAEx As UnauthorizedAccessException
            Console.WriteLine(uAEx.Message)
        Catch pathEx As PathTooLongException
            Console.WriteLine(pathEx.Message)
        End Try
    End Sub
End Module

Hinweise

Die ReadLines Methoden ReadAllLines und unterscheiden sich wie folgt: Wenn Sie verwenden ReadLines, können Sie mit dem Auflisten der Auflistung von Zeichen folgen beginnen, bevor die gesamte Auflistung zurückgegeben wird. ReadAllLinesWenn Sie verwenden, müssen Sie darauf warten, dass das gesamte Array von Zeichen folgen zurückgegeben wird, bevor Sie auf das Array zugreifen können.The ReadLines and ReadAllLines methods differ as follows: When you use ReadLines, you can start enumerating the collection of strings before the whole collection is returned; when you use ReadAllLines, you must wait for the whole array of strings be returned before you can access the array. Daher kann, wenn Sie mit sehr großen Dateien arbeiten, ReadLines effizienter sein.Therefore, when you are working with very large files, ReadLines can be more efficient.

Mit der ReadLines -Methode können Sie folgende Aufgaben ausführen:You can use the ReadLines method to do the following:

Diese Methode verwendet UTF8 für den Codierungs Wert.This method uses UTF8 for the encoding value.

ReadLines(String, Encoding) ReadLines(String, Encoding) ReadLines(String, Encoding)

Liest die Zeilen einer Datei mit einer angegebenen Codierung.Read the lines of a file that has a specified encoding.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ ReadLines(System::String ^ path, System::Text::Encoding ^ encoding);
public static System.Collections.Generic.IEnumerable<string> ReadLines (string path, System.Text.Encoding encoding);
static member ReadLines : string * System.Text.Encoding -> seq<string>

Parameter

path
String String String String

Die zu lesende Datei.The file to read.

encoding
Encoding Encoding Encoding Encoding

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

Gibt zurück

Alle Zeilen der Datei oder die Zeilen, die das Ergebnis einer Abfrage sind.All the lines of the file, or the lines that are the result of a query.

Ausnahmen

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

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

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

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

path überschreitet die vom System definierte maximale Länge.path exceeds the system-defined maximum length.

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

path gibt eine schreibgeschützte Datei an.path specifies 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 ist ein Verzeichnis.path is a directory.

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

Hinweise

Verwenden Sie diese Methode, um eine Codierung anzugeben, die zum Lesen der Datei verwendet werden soll.Use this method to specify an encoding to use read the file.

Die ReadLines Methoden ReadAllLines und unterscheiden sich wie folgt: Wenn Sie verwenden ReadLines, können Sie mit dem Auflisten der Auflistung von Zeichen folgen beginnen, bevor die gesamte Auflistung zurückgegeben wird.The ReadLines and ReadAllLines methods differ as follows: When you use ReadLines, you can start enumerating the collection of strings before the whole collection is returned. Wenn Sie verwenden ReadAllLines, müssen Sie darauf warten, dass das gesamte Array von Zeichen folgen zurückgegeben wird, bevor Sie auf das Array zugreifen können.When you use ReadAllLines, you must wait for the whole array of strings be returned before you can access the array. Daher kann, wenn Sie mit sehr großen Dateien arbeiten, ReadLines effizienter sein.Therefore, when you are working with very large files, ReadLines can be more efficient.

Mit der ReadLines -Methode können Sie folgende Aufgaben ausführen:You can use the ReadLines method to do the following:

Gilt für: