TextReader.Read 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
从文本读取器读取数据。
重载
| 名称 | 说明 |
|---|---|
| Read() |
从文本读取器中读取下一个字符，并将字符位置向前推进一个字符。 |
| Read(Span<Char>) |
从当前读取器读取字符并将数据写入指定的缓冲区。 |
| Read(Char[], Int32, Int32) |
从当前读取器读取指定的最大字符数，并将数据写入缓冲区，从指定的索引开始。 |
Read()
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
从文本读取器中读取下一个字符，并将字符位置向前推进一个字符。
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。
例外
出现 I/O 错误。
注解
该 TextReader 类是一个抽象类。 因此，不会在代码中实例化它。 有关使用 Read 该方法的示例，请参阅该方法 StreamReader.Read 。
另请参阅
适用于
Read(Span<Char>)
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
从当前读取器读取字符并将数据写入指定的缓冲区。
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)
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
- Source:
- TextReader.cs
从当前读取器读取指定的最大字符数，并将数据写入缓冲区，从指定的索引开始。
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 为负数。
出现 I/O 错误。
注解
此方法在读取字符或到达文件的末尾后 count 返回。
ReadBlock 是此方法的阻止版本。
该 TextReader 类是一个抽象类。 因此，不会在代码中实例化它。 有关使用 Read 该方法的示例，请参阅该方法 StreamReader.Read 。
