TextReader.ReadToEnd 메서드

정의

현재 위치에서 텍스트 판독기 끝까지의 모든 문자를 읽어서 단일 문자열로 반환합니다.Reads all characters from the current position to the end of the text reader and returns them as one string.

public:
 virtual System::String ^ ReadToEnd();
public virtual string ReadToEnd ();
abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> string
Public Overridable Function ReadToEnd () As String

반환

String

현재 위치에서 텍스트 판독기 끝까지의 모든 문자를 포함하는 문자열입니다.A string that contains all characters from the current position to the end of the text reader.

예외

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

TextReader가 닫혔습니다.The TextReader is closed.

메모리가 부족하여 반환된 문자열의 버퍼를 할당할 수 없습니다.There is insufficient memory to allocate a buffer for the returned string.

다음 줄의 문자 수가 MaxValue보다 큰 경우The number of characters in the next line is larger than MaxValue

설명

메서드가 예외를 throw 하는 경우 OutOfMemoryException 내부에서 판독기의 위치는 Stream 메서드에서 읽을 수 있었던 문자 수 만큼 이동 하지만 이미 내부 버퍼로 읽어온 문자는 ReadToEnd 삭제 됩니다.If the method throws an OutOfMemoryException exception, the reader's position in the underlying Stream is advanced by the number of characters the method was able to read, but the characters that were already read into the internal ReadToEnd buffer are discarded. 스트림에서 판독기의 위치를 변경할 수 없으므로 이미 읽은 문자는 복구할 수 없으며를 다시 초기화 해야만 액세스할 수 있습니다 TextReader .Because the position of the reader in the stream cannot be changed, the characters that were already read are unrecoverable and can be accessed only by reinitializing the TextReader. 스트림 내의 초기 위치를 알 수 없거나 스트림이 검색을 지원 하지 않는 경우 기본 Stream 도 다시 초기화 해야 합니다.If the initial position within the stream is unknown or the stream does not support seeking, the underlying Stream also needs to be reinitialized.

이러한 상황을 방지 하 고 강력한 코드를 생성 하려면 메서드를 사용 하 여 Read 읽기 문자를 미리 할당 된 버퍼에 저장 해야 합니다.To avoid such a situation and produce robust code you should use the Read method and store the read characters in a preallocated buffer.

TextReader 클래스는 추상 클래스입니다.The TextReader class is an abstract class. 따라서 코드에서 인스턴스화하지 않습니다.Therefore, you do not instantiate it in your code. 메서드를 사용 하는 예제는 ReadToEnd 메서드를 참조 하세요 StreamReader.ReadToEnd .For an example of using the ReadToEnd method, see the StreamReader.ReadToEnd method.

적용 대상

추가 정보