File.ReadLines 메서드

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

파일의 줄을 읽습니다.

오버로드

ReadLines(String)	파일의 줄을 읽습니다.
ReadLines(String, Encoding)	지정된 인코딩을 가진 파일의 줄을 읽습니다.

ReadLines(String)

Source:

File.cs

파일의 줄을 읽습니다.

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)

매개 변수

path

String

읽을 파일입니다.

반환

IEnumerable<String>

파일의 모든 줄 또는 쿼리 결과의 줄입니다.

예외

ArgumentException

2.1보다 오래된 .NET Framework 및 .NET Core 버전: path 길이가 0인 문자열이거나, 공백만 포함하거나, 메서드에서 정의한 GetInvalidPathChars() 하나 이상의 잘못된 문자를 포함합니다.

ArgumentNullException

path이(가) null인 경우

DirectoryNotFoundException

path가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).

FileNotFoundException

path로 지정된 파일을 찾을 수 없습니다.

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

PathTooLongException

path가 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

UnauthorizedAccessException

path가 읽기 전용 파일을 지정합니다.

또는

현재 플랫폼이 해당 작업을 지원하지 않는 경우

또는

path는 디렉터리입니다.

또는

호출자에게 필요한 권한이 없는 경우

예제

다음 예제에서는 파일의 줄을 읽어 지정된 문자열을 포함하는 줄을 찾습니다.

foreach (string line in File.ReadLines(@"d:\data\episodes.txt"))
{
    if (line.Contains("episode") & line.Contains("2006"))
    {
        Console.WriteLine(line);
    }
}

for line in File.ReadLines @"d:\data\episodes.txt" do
    if line.Contains "episode" && line.Contains "2006" then
        printfn $"{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

다음 예제에서는 LINQ 쿼리에서 메서드를 사용하여 ReadLines 확장명이 .txt 파일에 대한 모든 디렉터리를 열거하고, 파일의 각 줄을 읽고, 문자열 "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);
        }
    }
}

open System
open System.IO

try
    // Set a variable to the My Documents path.
    let docPath =
        Environment.GetFolderPath Environment.SpecialFolder.MyDocuments

    let files =
        query {
            for file in Directory.EnumerateFiles(docPath, "*.txt", SearchOption.AllDirectories) do
            for line in File.ReadLines file do
            where (line.Contains "Microsoft")
            select {| File = file; Line = line |}
        }

    for f in files do
        printfn $"{f.File}\t{f.Line}"
    printfn $"{Seq.length files} files found."

with
| :? UnauthorizedAccessException as uAEx -> printfn $"{uAEx.Message}"
| :? PathTooLongException as pathEx -> printfn $"{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

설명

및 메서드는 ReadLines 다음과 같이 다릅니다. 를 사용하면 ReadLines전체 컬렉션이 반환되기 전에 문자열 컬렉션을 열거할 수 있습니다. 를 사용하는 ReadAllLines경우 전체 문자열 배열이 반환될 때까지 기다려야 배열에 액세스할 수 ReadAllLines 있습니다. 따라서 매우 큰 파일 ReadLines 로 작업할 때 보다 효율적일 수 있습니다.

메서드를 ReadLines 사용하여 다음을 수행할 수 있습니다.

• 파일에서 LINQ to Objects 쿼리를 수행하여 필터링된 줄 집합을 가져옵니다.

• 반환된 줄 컬렉션을 메서드를 사용하여 파일에 File.WriteAllLines(String, IEnumerable<String>) 쓰거나 메서드를 사용하여 기존 파일에 File.AppendAllLines(String, IEnumerable<String>) 추가합니다.

• 또는 와 같이 IList<T>Queue<T>해당 생성자에 대한 문자열 컬렉션을 사용하는 컬렉션의 즉시 채워진 instance 만듭니다IEnumerable<T>.

이 메서드는 인코딩 값에 를 사용합니다 UTF8 .

ReadLines(String, Encoding)

Source:

File.cs

지정된 인코딩을 가진 파일의 줄을 읽습니다.

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>

Public Shared Function ReadLines (path As String, encoding As Encoding) As IEnumerable(Of String)

매개 변수

path

String

읽을 파일입니다.

encoding

Encoding

파일의 내용에 적용되는 인코딩입니다.

반환

IEnumerable<String>

파일의 모든 줄 또는 쿼리 결과의 줄입니다.

예외

ArgumentException

2.1보다 오래된 .NET Framework 및 .NET Core 버전: path 길이가 0인 문자열이거나, 공백만 포함하거나, 메서드에 정의된 GetInvalidPathChars() 하나 이상의 잘못된 문자를 포함합니다.

ArgumentNullException

path이(가) null인 경우

DirectoryNotFoundException

path가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).

FileNotFoundException

path로 지정된 파일을 찾을 수 없습니다.

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

PathTooLongException

path가 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

UnauthorizedAccessException

path가 읽기 전용 파일을 지정합니다.

또는

현재 플랫폼이 해당 작업을 지원하지 않는 경우

또는

path는 디렉터리입니다.

또는

호출자에게 필요한 권한이 없는 경우

설명

이 메서드를 사용하여 파일 읽기를 사용할 인코딩을 지정합니다.

및 ReadAllLines 메서드는 ReadLines 다음과 같이 다릅니다. 를 사용하는 ReadLines경우 전체 컬렉션이 반환되기 전에 문자열 컬렉션을 열거할 수 있습니다. 를 사용하는 ReadAllLines경우 배열에 액세스하기 전에 전체 문자열 배열이 반환될 때까지 기다려야 합니다. 따라서 매우 큰 파일 ReadLines 로 작업할 때 보다 효율적일 수 있습니다.

메서드를 ReadLines 사용하여 다음을 수행할 수 있습니다.

• 파일에서 LINQ to Objects 쿼리를 수행하여 필터링된 줄 집합을 가져옵니다.

• 반환된 줄 컬렉션을 메서드를 사용하여 파일에 File.WriteAllLines(String, IEnumerable<String>, Encoding) 쓰거나 메서드를 사용하여 기존 파일에 File.AppendAllLines(String, IEnumerable<String>, Encoding) 추가합니다.

• 또는 와 같이 IList<T>Queue<T>해당 생성자에 대한 문자열 컬렉션을 사용하는 컬렉션의 즉시 채워진 instance 만듭니다IEnumerable<T>.