StringReader.Read 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

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

重载

Read()	读取输入字符串中的下一个字符并将该字符的位置提升一个字符。
Read(Span<Char>)	从当前位置开始读取输入字符串中的所有字符，并将当前位置移到输入字符串的末尾。
Read(Char[], Int32, Int32)	读取输入字符串中的字符块，并将字符位置提升 count。

Read()

Source:

StringReader.cs

读取输入字符串中的下一个字符并将该字符的位置提升一个字符。

public:
 override int Read();

public override int Read ();

override this.Read : unit -> int

Public Overrides Function Read () As Integer

返回

Int32

基础字符串中的下一个字符，或者如果没有更多的可用字符，则为 -1。

例外

ObjectDisposedException

当前读取器已关闭。

示例

此代码示例是为 StringReader 类提供的一个更大示例的一部分。

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

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
从二进制文件读取。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入

另请参阅

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

Read(Span<Char>)

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>

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

返回

Int32

读入缓冲区的总字符数。

例外

ObjectDisposedException

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

Read(Char[], Int32, Int32)

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

要读取的字符数。

返回

Int32

读入缓冲区的总字符数。 如果当前没有那么多字符可用，则总字符数可能会少于所请求的字符数，或者如果已到达基础字符串的结尾，则总字符数为零。

例外

ArgumentNullException

buffer 为 null。

ArgumentException

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

ArgumentOutOfRangeException

index 或 count 为负数。

ObjectDisposedException

当前读取器已关闭。

注解

此方法重写 TextReader.Read。

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

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

若要执行此操作...	请参见本主题中的示例...
创建文本文件。	如何：将文本写入文件
写入文本文件。	如何：将文本写入文件
从文本文件读取。	如何：从文件中读取文本
将文本追加到文件。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
获取文件的大小。	FileInfo.Length
获取文件的属性。	File.GetAttributes
设置文件的属性。	File.SetAttributes
确定文件是否存在。	File.Exists
从二进制文件读取。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入

另请参阅

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