TextReader.Read 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
텍스트 판독기에서 데이터를 읽습니다.
오버로드
| Read() |
텍스트 판독기에서 다음 문자를 읽고 문자 위치를 한 문자씩 앞으로 이동합니다. |
| Read(Span<Char>) |
현재 판독기에서 문자를 읽고, 지정된 버퍼에 씁니다. |
| Read(Char[], Int32, Int32) |
현재 판독기에서 지정된 최대 수의 문자를 읽어 이 데이터를 지정된 인덱스에서 시작되는 버퍼에 씁니다. |
Read()
텍스트 판독기에서 다음 문자를 읽고 문자 위치를 한 문자씩 앞으로 이동합니다.
public:
virtual int Read();public virtual int Read ();abstract member Read : unit -> int
override this.Read : unit -> intPublic Overridable Function Read () As Integer반환
텍스트 판독기의 다음 문자 또는 사용할 수 있는 문자가 더 이상 없는 경우 -1입니다. 기본 구현된 경우에는 -1을 반환합니다.
예외
TextReader가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
TextReader 클래스는 추상 클래스입니다. 따라서 코드에서 인스턴스화하지 않습니다. 메서드를 사용하는 예제는 Read 메서드를 참조하세요 StreamReader.Read .
추가 정보
적용 대상
Read(Span<Char>)
현재 판독기에서 문자를 읽고, 지정된 버퍼에 씁니다.
public:
virtual int Read(Span<char> buffer);public virtual int Read (Span<char> buffer);abstract member Read : Span<char> -> int
override this.Read : Span<char> -> intPublic Overridable Function Read (buffer As Span(Of Char)) As Integer매개 변수
반환
읽은 문자 수입니다. 데이터를 판독기 내에서 사용할 수 있는지에 따라 이 수는 buffer의 길이보다 작거나 같을 수 있습니다. 읽을 문자가 더 이상 없는 경우에 이 메서드를 호출하면 0이 반환됩니다.
예외
buffer이(가) null인 경우
스트림에서 읽은 문자의 수는 buffer의 길이보다 큽니다.
적용 대상
Read(Char[], Int32, Int32)
현재 판독기에서 지정된 최대 수의 문자를 읽어 이 데이터를 지정된 인덱스에서 시작되는 버퍼에 씁니다.
public:
virtual int Read(cli::array <char> ^ buffer, int index, int count);public virtual int Read (char[] buffer, int index, int count);abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> intPublic Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer매개 변수
- buffer
- Char[]
이 메서드는 지정된 문자 배열의 값이 index와 (index + count - 1) 사이에서 현재 원본으로부터 읽어온 문자로 교체된 상태로 반환됩니다.
- index
- Int32
쓰기를 시작할 buffer의 위치입니다.
- count
- Int32
읽을 최대 문자 수입니다. 지정한 문자 수를 버퍼로 읽어오기 전에 판독기의 끝에 도달하면 메서드가 반환됩니다.
반환
읽은 문자 수입니다. 이 문자 수는 판독기 내에서 데이터를 사용할 수 있는지 여부에 따라 count보다 작거나 같습니다. 읽을 문자가 더 이상 없는 경우에 이 메서드를 호출하면 0이 반환됩니다.
예외
buffer이(가) null인 경우
버퍼 길이에서 index를 빼면 count보다 작습니다.
index 또는 count가 음수입니다.
TextReader가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
이 메서드는 문자를 읽거나 파일의 끝에 도달한 후 count 반환됩니다. ReadBlock 는 이 메서드의 차단 버전입니다.
TextReader 클래스는 추상 클래스입니다. 따라서 코드에서 인스턴스화하지 않습니다. 메서드를 사용하는 예제는 Read 메서드를 참조하세요 StreamReader.Read .