FileStream.Flush Método

Definição

Namespace:

System.IO

Assemblies:

mscorlib.dll, System.IO.FileSystem.dll

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

System.IO.FileSystem.dll

Assembly:

mscorlib.dll

Limpa os buffers desse fluxo e faz com que todos os dados armazenados em buffer sejam gravados no arquivo.

Sobrecargas

Flush()	Limpa os buffers desse fluxo e faz com que todos os dados armazenados em buffer sejam gravados no arquivo.
Flush(Boolean)	Limpa os buffers desse fluxo e faz com que os dados armazenados em buffer sejam gravados no arquivo e também limpa todos os buffers de arquivo intermediário.

Flush()

Limpa os buffers desse fluxo e faz com que todos os dados armazenados em buffer sejam gravados no arquivo.

public:
 override void Flush();

public override void Flush ();

override this.Flush : unit -> unit

Public Overrides Sub Flush ()

Exceções

IOException

Ocorreu um erro de E/S.

ObjectDisposedException

O fluxo está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para o Lock método.

// Update the file.
case 'W':
   try
   {
      fileStream->Seek( textLength, SeekOrigin::Begin );
      fileStream->Read( readText, textLength - 1, byteCount );
      tempString = gcnew String( uniEncoding->GetChars( readText, textLength - 1, byteCount ) );
      recordNumber = Int32::Parse( tempString ) + 1;
      fileStream->Seek( textLength, SeekOrigin::Begin );
      fileStream->Write( uniEncoding->GetBytes( recordNumber.ToString() ), 0, byteCount );
      fileStream->Flush();
      Console::WriteLine( "Record has been updated." );
   }

// Update the file.
case 'W':
    try
    {
        fileStream.Seek(textLength,
            SeekOrigin.Begin);
        fileStream.Read(
            readText, textLength - 1, byteCount);
        tempString = new String(
            uniEncoding.GetChars(
            readText, textLength - 1, byteCount));
        recordNumber = int.Parse(tempString) + 1;
        fileStream.Seek(
            textLength, SeekOrigin.Begin);
        fileStream.Write(uniEncoding.GetBytes(
            recordNumber.ToString()),
            0, byteCount);
        fileStream.Flush();
        Console.WriteLine(
            "Record has been updated.");
    }

' Update the file.
Case "W"C
    Try
        aFileStream.Seek(textLength, _
            SeekOrigin.Begin)
        aFileStream.Read( _
            readText, textLength - 1, byteCount)
        tempString = New String( _
            uniEncoding.GetChars( _
            readText, textLength - 1, byteCount))
        recordNumber = _
            Integer.Parse(tempString) + 1
        aFileStream.Seek( _
            textLength, SeekOrigin.Begin)
        aFileStream.Write(uniEncoding.GetBytes( _
            recordNumber.ToString()), 0, byteCount)
        aFileStream.Flush()
        Console.WriteLine( _
            "Record has been updated.")

Comentários

Este método substitui Stream.Flush.

Quando você chama o FileStream.Flush método, o buffer de e/s do sistema operacional também é liberado.

O codificador de um fluxo não é liberado, a menos que você chame explicitamente Flush ou descarte o objeto. Definir StreamWriter.AutoFlush como true significa que os dados serão liberados do buffer para o fluxo, mas o estado do codificador não será liberado. Isso permite que o codificador Mantenha seu estado (caracteres parciais) para que ele possa codificar corretamente o próximo bloco de caracteres. Esse cenário afeta UTF8 e UTF7, em que determinados caracteres só podem ser codificados depois que o codificador recebe o caractere ou caracteres adjacentes.

Como um buffer pode ser usado para leitura ou gravação, Flush() o executa as duas funções a seguir:

• Todos os dados gravados anteriormente no buffer são copiados para o arquivo e o buffer é limpo, exceto para seu estado de codificador.

• Se BufferedStream.CanSeek for true e os dados tiverem sido copiados anteriormente do arquivo para o buffer para leitura, a posição atual dentro do arquivo será diminuída pelo número de bytes não lidos no buffer. O buffer é então apagado.

Use a Flush(Boolean) sobrecarga do método quando desejar garantir que todos os dados armazenados em buffer em buffers de arquivos intermediários sejam gravados no disco.

Confira também

• Flush(Boolean)
• Como: gravar texto em um arquivo

Flush(Boolean)

Limpa os buffers desse fluxo e faz com que os dados armazenados em buffer sejam gravados no arquivo e também limpa todos os buffers de arquivo intermediário.

public:
 virtual void Flush(bool flushToDisk);

public virtual void Flush (bool flushToDisk);

override this.Flush : bool -> unit

Public Overridable Sub Flush (flushToDisk As Boolean)

Parâmetros

flushToDisk

Boolean

true para limpar todos os buffers de arquivo intermediário; caso contrário, false.

Comentários

Use essa sobrecarga quando desejar garantir que todos os dados armazenados em buffer em buffers de arquivos intermediários sejam gravados no disco.

Quando você chama o Flush método, o buffer de e/s do sistema operacional também é liberado.

Confira também

• Flush()