영어로 읽기

다음을 통해 공유

StreamReader.ReadToEnd 메서드

  • 참조

정의

네임스페이스:
System.IO
어셈블리:
System.IO.dll
어셈블리:
System.Runtime.dll
어셈블리:
System.Runtime.Extensions.dll
어셈블리:
mscorlib.dll
어셈블리:
netstandard.dll
Source:
StreamReader.cs
Source:
StreamReader.cs
Source:
StreamReader.cs

현재 위치부터 스트림 끝까지의 모든 문자를 읽습니다.

public override string ReadToEnd ();

반환

String

현재 위치에서 끝까지의 스트림은 문자열입니다. 현재 위치가 스트림 끝에 있으면 빈 문자열("")을 반환합니다.

예외

OutOfMemoryException

메모리가 부족하여 반환된 문자열의 버퍼를 할당할 수 없습니다.

IOException

I/O 오류가 발생했습니다.

예제

다음 코드 예제에서는 한 작업에서 파일의 끝까지 읽습니다.

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path))
            {
                //This allows you to do one Read operation.
                Console.WriteLine(sr.ReadToEnd());
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

설명

이 메서드는 TextReader.ReadToEnd를 재정의합니다.

ReadToEnd 현재 위치에서 스트림의 끝까지 모든 입력을 읽어야 할 때 가장 잘 작동합니다. 스트림에서 읽는 문자 수에 대해 더 많은 제어가 필요한 경우 메서드 오버로드를 Read(Char[], Int32, Int32) 사용하여 일반적으로 성능이 향상됩니다.

ReadToEnd 는 스트림이 끝에 도달했을 때를 알고 있다고 가정합니다. 서버가 데이터를 요청하고 연결을 ReadToEnd 닫지 않는 경우에만 데이터를 보내는 대화형 프로토콜의 경우 는 끝에 도달하지 않으므로 무기한 차단될 수 있으며 피해야 합니다.

메서드를 사용하는 경우 스트림의 Read 내부 버퍼와 크기가 같은 버퍼를 사용하는 것이 더 효율적입니다. 스트림이 생성될 때 버퍼의 크기가 지정되지 않은 경우 기본 크기는 4KB(4096바이트)입니다.

현재 메서드가 을 OutOfMemoryExceptionthrow하는 경우 기본 개체의 판독기 Stream 위치는 메서드가 읽을 수 있는 문자 수로 고급화되지만 내부 ReadLine 버퍼로 이미 읽은 문자는 삭제됩니다. 데이터를 버퍼로 읽은 후 기본 스트림의 위치를 조작하는 경우 기본 스트림의 위치가 내부 버퍼의 위치와 일치하지 않을 수 있습니다. 내부 버퍼를 다시 설정하려면 메서드를 DiscardBufferedData 호출합니다. 그러나 이 메서드는 성능이 느려지고 절대적으로 필요한 경우에만 호출해야 합니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

적용 대상

제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

추가 정보