Stream.Flush Metoda

Definicja

Gdy jest zastępowany w klasie pochodnej, czyści wszystkie bufory dla tego strumienia i powoduje, że wszystkie buforowane dane są zapisywane na podstawowym urządzeniu.When overridden in a derived class, clears all buffers for this stream and causes any buffered data to be written to the underlying device.

public:
 abstract void Flush();
public abstract void Flush ();
abstract member Flush : unit -> unit
Public MustOverride Sub Flush ()

Wyjątki

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Zastąp Flush strumienie implementujące bufor.Override Flush on streams that implement a buffer. Użyj tej metody, aby przenieść wszystkie informacje z bazowego buforu do jego lokalizacji docelowej, wyczyść bufor lub oba te elementy.Use this method to move any information from an underlying buffer to its destination, clear the buffer, or both. W zależności od stanu obiektu może zajść potrzeba zmodyfikowania bieżącej pozycji w strumieniu (na przykład jeśli źródłowy strumień obsługuje wyszukiwanie).Depending upon the state of the object, you might have to modify the current position within the stream (for example, if the underlying stream supports seeking). Aby uzyskać dodatkowe informacje, zobacz CanSeek .For additional information see CanSeek.

W klasie pochodnej Stream , która nie obsługuje pisania, Flush jest zwykle implementowana jako pusta Metoda w celu zapewnienia pełnej zgodności z innymi Stream typami, ponieważ jest ona prawidłowa do opróżniania strumienia tylko do odczytu.In a class derived from Stream that doesn't support writing, Flush is typically implemented as an empty method to ensure full compatibility with other Stream types since it's valid to flush a read-only stream.

Korzystając z StreamWriter klasy or BinaryWriter , nie Opróżniaj Stream obiektu podstawowego.When using the StreamWriter or BinaryWriter class, do not flush the base Stream object. Zamiast tego należy użyć klasy Flush lub Close metody, aby upewnić się, że dane są najpierw opróżniane do strumienia bazowego, a następnie zapisywane do pliku.Instead, use the class's Flush or Close method, which makes sure that the data is flushed to the underlying stream first and then written to the file.

Dotyczy