TextReader.Read 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

从文本读取器读取数据。

重载

Read()	读取文本读取器中的下一个字符并使该字符的位置前移一个字符。
Read(Span<Char>)	从当前读取器中读取字符，并将数据写入指定的缓冲区。
Read(Char[], Int32, Int32)	从当前读取器中读取指定数目的字符并从指定索引开始将该数据写入缓冲区。

Read()

Source:

TextReader.cs

读取文本读取器中的下一个字符并使该字符的位置前移一个字符。

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。

例外

ObjectDisposedException

TextReader 是关闭的。

IOException

出现 I/O 错误。

注解

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 Read 方法的示例，请参阅 StreamReader.Read 方法。

另请参阅

• Read()
• Read()
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

Read(Span<Char>)

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> -> int

Public Overridable Function Read (buffer As Span(Of Char)) As Integer

参数

buffer

Span<Char>

此方法返回时，包含指定的字符范围，这些字符由从当前源中读取的字符替换。

返回

Int32

已读取的字符数。 该数小于或等于 buffer 长度，具体取决于读取器中是否有可用的数据。 如果调用此方法时没有留下更多的字符供读取，则此方法返回 0（零）。

例外

ArgumentNullException

buffer 为 null。

IOException

从流中读取的字符数大于 buffer 的长度。

Read(Char[], Int32, Int32)

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 -> 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（零）。

例外

ArgumentNullException

buffer 为 null。

ArgumentException

缓冲区长度减去 index 小于 count。

ArgumentOutOfRangeException

index 或 count 为负数。

ObjectDisposedException

TextReader 是关闭的。

IOException

出现 I/O 错误。

注解

此方法在读取字符 count 或到达文件末尾后返回。 ReadBlock 是此方法的阻止版本。

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 Read 方法的示例，请参阅 StreamReader.Read 方法。

另请参阅

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件