StreamReader.DiscardBufferedData Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Очищает внутренний буфер.
public:
void DiscardBufferedData();
public void DiscardBufferedData ();
member this.DiscardBufferedData : unit -> unit
Public Sub DiscardBufferedData ()
Примеры
В следующем примере показан сценарий, в котором DiscardBufferedData метод должен быть вызван для синхронизации внутреннего буфера и базового потока. Файл в примере используется для иллюстрации расположения и состоит из текста abcdefghijklmnopqrstuvwxyz
. Вызывая DiscardBufferedData после считывания данных, пример работает правильно. После считывания первых 15 символов позиция сбрасывается до значения offset, равного 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 объекта более одного раза.
Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.