StringReader.Read 方法

定义

从输入字符串中读取下一个字符或下一组字符。

重载

名称 说明
Read()

从输入字符串中读取下一个字符,并将字符位置向前推进一个字符。

Read(Span<Char>)

从输入字符串读取所有字符,从当前位置开始,并将当前位置前进到输入字符串的末尾。

Read(Char[], Int32, Int32)

从输入字符串中读取字符块,并按此方式 count推进字符位置。

Read()

Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs

从输入字符串中读取下一个字符,并将字符位置向前推进一个字符。

public:
 override int Read();
public override int Read();
override this.Read : unit -> int
Public Overrides Function Read () As Integer

返回

基础字符串中的下一个字符;如果没有更多字符可用,则 -1。

例外

当前读取器已关闭。

示例

该代码示例是 StringReader 类中的一个较大示例的一部分。

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}
convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

注解

此方法替代 TextReader.Read 该方法。

下表列出了其他典型或相关的 I/O 任务的示例。

执行此操作... 请参阅本主题中的示例...
创建文本文件。 如何:将文本写入文件
写入文本文件。 如何:将文本写入文件
从文本文件中读取。 如何:从文件读取文本
将文本追加到文件中。 如何:打开日志文件并将其追加到日志文件

File.AppendText

FileInfo.AppendText
获取文件的大小。 FileInfo.Length
获取文件的属性。 File.GetAttributes
设置文件的属性。 File.SetAttributes
确定文件是否存在。 File.Exists
从二进制文件读取。 如何:读取和写入新创建的数据文件
写入二进制文件。 如何:读取和写入新创建的数据文件

另请参阅

适用于

Read(Span<Char>)

Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs

从输入字符串读取所有字符,从当前位置开始,并将当前位置前进到输入字符串的末尾。

public:
 override int Read(Span<char> buffer);
public override int Read(Span<char> buffer);
override this.Read : Span<char> -> int
Public Overrides Function Read (buffer As Span(Of Char)) As Integer

参数

buffer
Span<Char>

此方法返回时,包含从当前源读取的字符。 如果读取的字符总数为零,则范围保持不变。

返回

读取到缓冲区中的字符总数。

例外

当前字符串读取器实例已关闭。

适用于

Read(Char[], Int32, Int32)

Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs
Source:
StringReader.cs

从输入字符串中读取字符块,并按此方式 count推进字符位置。

public:
 override int Read(cli::array <char> ^ buffer, int index, int count);
public override int Read(char[] buffer, int index, int count);
override this.Read : char[] * int * int -> int
Public Overrides Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

参数

buffer
Char[]

此方法返回时,包含指定的字符数组,其值介于 index 和 (index + count - 1) 之间,由从当前源中读取的字符替换。

index
Int32

缓冲区中的起始索引。

count
Int32

要读取的字符数。

返回

读取到缓冲区中的字符总数。 如果多个字符当前不可用,则这可以小于请求的字符数;如果已到达基础字符串的末尾,则为零。

例外

buffernull

缓冲区长度减号 index 小于 count

indexcount 为负数。

当前读取器已关闭。

注解

此方法重写 TextReader.Read

该方法将从字符数组读取到count从位置StringReader开始的buffer字符index数组。 返回读取的实际字符数;如果已达到字符串的末尾且未读取任何字符,则返回零。

下表列出了其他典型或相关的 I/O 任务的示例。

执行此操作... 请参阅本主题中的示例...
创建文本文件。 如何:将文本写入文件
写入文本文件。 如何:将文本写入文件
从文本文件中读取。 如何:从文件读取文本
将文本追加到文件中。 如何:打开日志文件并将其追加到日志文件

File.AppendText

FileInfo.AppendText
获取文件的大小。 FileInfo.Length
获取文件的属性。 File.GetAttributes
设置文件的属性。 File.SetAttributes
确定文件是否存在。 File.Exists
从二进制文件读取。 如何:读取和写入新创建的数据文件
写入二进制文件。 如何:读取和写入新创建的数据文件

另请参阅

适用于