Stream.Flush Stream.Flush Stream.Flush Stream.Flush Method

Definition

Löscht beim Überschreiben in einer abgeleiteten Klasse alle Puffer für diesen Stream und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät.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 ()

Ausnahmen

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Über Flush schreiben Sie in Streams, die einen Puffer implementieren.Override Flush on streams that implement a buffer. Verwenden Sie diese Methode, um alle Informationen aus einem zugrunde liegenden Puffer in das Ziel zu verschieben, den Puffer zu löschen oder beides.Use this method to move any information from an underlying buffer to its destination, clear the buffer, or both. Abhängig vom Zustand des Objekts müssen Sie möglicherweise die aktuelle Position innerhalb des Streams ändern (z. b. wenn der zugrunde liegende Stream Suchvorgänge unterstützt).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). Weitere Informationen finden Sie unter CanSeek.For additional information see CanSeek.

In einer von Stream abgeleiteten Klasse, die Schreibvorgänge nicht unterstützt, wird in der Regel als leere Methode implementiert, Stream um die vollständige Kompatibilität mit anderen Typen sicherzustellen, Flush da ein Schreib geschützter Stream ungültig ist.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.

Wenn Sie die StreamWriter - BinaryWriter Klasse oder die-Klasse verwenden, Stream sollten Sie das Basisobjekt nicht leeren.When using the StreamWriter or BinaryWriter class, do not flush the base Stream object. Verwenden Sie stattdessen die-oder Flush Close -Methode der-Klasse, die sicherstellt, dass die Daten zuerst in den zugrunde liegenden Stream geleert und dann in die Datei geschrieben werden.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.

Gilt für:

Siehe auch