StreamReader.DiscardBufferedData Método

Definición

Borra el búfer interno.Clears the internal buffer.

public:
 void DiscardBufferedData();
public void DiscardBufferedData ();
member this.DiscardBufferedData : unit -> unit
Public Sub DiscardBufferedData ()

Ejemplos

En el ejemplo siguiente se muestra un escenario en el que DiscardBufferedData se debe llamar al método para sincronizar el búfer interno y el flujo subyacente.The following example shows a scenario where the DiscardBufferedData method must be called to synchronize the internal buffer and the underlying stream. El archivo del ejemplo se usa para mostrar la posición y consta del texto abcdefghijklmnopqrstuvwxyz .The file in the example is used to illustrate position and consists of the text abcdefghijklmnopqrstuvwxyz. Al llamar a DiscardBufferedData después de leer los datos, el ejemplo funciona según lo esperado.By calling DiscardBufferedData after the data is read, the example works as expected. Después de leer los 15 primeros caracteres, la posición se restablece en el valor de desplazamiento de 2 y se leen todos los caracteres restantes.After the first 15 characters are read, the position is reset to the offset value of 2 and all the remaining characters are read. Si quita la llamada a DiscardBufferedData , el ejemplo no funciona como se esperaba.If you remove the call to DiscardBufferedData, the example does not work as expected. Se leen los 15 primeros caracteres, pero solo se restablece la posición de la secuencia subyacente.The first 15 characters are read, but only the position of the underlying stream is reset. El búfer interno del StreamReader objeto todavía está en el carácter 16.The internal buffer of the StreamReader object is still on the 16th character. Por lo tanto, ReadToEnd devuelve todos los caracteres del búfer más los caracteres de la secuencia subyacente a partir de la posición de restablecimiento.Therefore, ReadToEnd returns all the characters in the buffer plus the characters in the underlying stream starting from the reset position.

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

Comentarios

Use el DiscardBufferedData método para restablecer el búfer interno del StreamReader objeto.Use the DiscardBufferedData method to reset the internal buffer for the StreamReader object. Solo tiene que llamar a este método cuando la posición del búfer interno y el no BaseStream coinciden.You need to call this method only when the position of the internal buffer and the BaseStream do not match. Estas posiciones pueden dejar de coincidir cuando se leen datos en el búfer y, a continuación, se busca una nueva posición en la secuencia subyacente.These positions can become mismatched when you read data into the buffer and then seek a new position in the underlying stream. Este método reduce el rendimiento y debe usarse solo cuando es absolutamente necesario, por ejemplo, cuando desea leer una parte del contenido de un StreamReader objeto más de una vez.This method slows performance and should be used only when absolutely necessary, such as when you want to read a portion of the contents of a StreamReader object more than once.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Se aplica a