StreamReader.DiscardBufferedData 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

Source:

StreamReader.cs

清除内部缓冲区。

public:
 void DiscardBufferedData();

public void DiscardBufferedData ();

member this.DiscardBufferedData : unit -> unit

Public Sub DiscardBufferedData ()

示例

以下示例演示了必须调用 方法来同步内部缓冲区和基础流的情况 DiscardBufferedData 。 示例中的 文件用于说明位置，由文本 abcdefghijklmnopqrstuvwxyz组成。 通过在读取数据后调用 DiscardBufferedData ，示例按预期工作。 读取前 15 个字符后，位置将重置为偏移值 2，并读取所有剩余字符。 如果删除对 DiscardBufferedData的调用，该示例不会按预期工作。 前 15 个字符是读取的，但仅重置基础流的位置。 对象的内部缓冲区 StreamReader 仍位于第 16 个字符上。 因此， ReadToEnd 返回缓冲区中的所有字符以及从重置位置开始的基础流中的字符。

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\alphabet.txt";

        using (StreamReader sr = new StreamReader(path))
        {
            char[] c = null;

            c = new char[15];
            sr.Read(c, 0, c.Length);
            Console.WriteLine("first 15 characters:");
            Console.WriteLine(c);
            // writes - "abcdefghijklmno"

            sr.DiscardBufferedData();
            sr.BaseStream.Seek(2, SeekOrigin.Begin);
            Console.WriteLine("\nBack to offset 2 and read to end: ");
            Console.WriteLine(sr.ReadToEnd());
            // writes - "cdefghijklmnopqrstuvwxyz"
            // without DiscardBufferedData, writes - "pqrstuvwxyzcdefghijklmnopqrstuvwxyz"
        }
    }
}

Imports System.IO

Module Module1

    Sub Main()
        Dim path As String = "c:\temp\alphabet.txt"

        Dim sr As StreamReader = New StreamReader(path)
        Dim c(14) As Char

        sr.Read(c, 0, c.Length)
        Console.WriteLine("first 15 characters:")
        Console.WriteLine(c)
        ' writes - "abcdefghijklmno"

        sr.DiscardBufferedData()
        sr.BaseStream.Seek(2, SeekOrigin.Begin)
        Console.WriteLine(Environment.NewLine & "Back to offset 2 and read to end: ")
        Console.WriteLine(sr.ReadToEnd())
        ' writes - "cdefghijklmnopqrstuvwxyz"
        ' without DiscardBufferedData, writes - "pqrstuvwxyzcdefghijklmnopqrstuvwxyz"
        sr.Close()
    End Sub

End Module

注解

DiscardBufferedData使用 方法重置 对象的内部缓冲区StreamReader。 仅当内部缓冲区的位置和 不匹配时， BaseStream 才需要调用此方法。 将数据读入缓冲区，然后在基础流中查找新位置时，这些位置可能会不匹配。 此方法会降低性能，仅当绝对必要时才应使用，例如，当你想要多次读取对象的部分 StreamReader 内容时。

有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。

另请参阅

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