TextReader.Read 메서드

정의

텍스트 판독기에서 데이터를 읽습니다.

오버로드

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 -> int
Public Overridable Function Read () As Integer

반환

Int32

텍스트 판독기의 다음 문자 또는 사용할 수 있는 문자가 더 이상 없는 경우 -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> -> int
Public Overridable Function Read (buffer As Span(Of Char)) As Integer

매개 변수

buffer
Span<Char>

이 메서드가 반환될 경우, 현재의 소스에서 읽은 문자로 대체된 문자의 지정된 범위를 포함합니다.

반환

Int32

읽은 문자 수입니다. 데이터를 판독기 내에서 사용할 수 있는지에 따라 이 수는 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 -> int
Public 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

읽을 최대 문자 수입니다. 지정한 문자 수를 버퍼로 읽어오기 전에 판독기의 끝에 도달하면 메서드가 반환됩니다.

반환

Int32

읽은 문자 수입니다. 이 문자 수는 판독기 내에서 데이터를 사용할 수 있는지 여부에 따라 count보다 작거나 같습니다. 읽을 문자가 더 이상 없는 경우에 이 메서드를 호출하면 0이 반환됩니다.

예외

buffer이(가) null인 경우

버퍼 길이에서 index를 빼면 count보다 작습니다.

index 또는 count가 음수입니다.

TextReader가 닫혔습니다.

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

설명

이 메서드는 문자를 읽거나 파일 끝에 도달한 후에 count 반환됩니다. ReadBlock 는 이 메서드의 차단 버전입니다.

TextReader 클래스는 추상 클래스입니다. 따라서 코드에서 인스턴스화하지 않습니다. 메서드를 사용하는 예제는 Read 메서드를 참조하세요 StreamReader.Read .

추가 정보

적용 대상