Stream.Dispose Stream.Dispose Stream.Dispose Stream.Dispose Method

Definition

Gibt alle vom Stream-Objekt verwendeten Ressourcen frei.Releases all resources used by the Stream object.

Überlädt

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Stream verwendeten Ressourcen frei.Releases all resources used by the Stream.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Stream verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Stream and optionally releases the managed resources.

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Stream verwendeten Ressourcen frei.Releases all resources used by the Stream.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementiert

Hinweise

Diese Methode löscht den Stream, indem alle Änderungen in den Sicherungs Speicher geschrieben und der Stream zum Freigeben von Ressourcen geschlossen wird.This method disposes the stream, by writing any changes to the backing store and closing the stream to release resources.

Durch Aufrufen Dispose von können die Ressourcen ,dievonverwendetwerden,fürandereZweckeneuzugeordnetwerden.StreamCalling Dispose allows the resources used by the Stream to be reallocated for other purposes. Weitere Informationen zu finden DisposeSie unter Bereinigen von nicht verwalteten Ressourcen.For more information about Dispose, see Cleaning Up Unmanaged Resources.

Hinweise für Vererber

Platzieren Sie alle Bereinigungs Logik für das Daten Dispose(Boolean)Strom Objekt in.Place all cleanup logic for your stream object in Dispose(Boolean). Nicht außer Kraft Close()setzen.Do not override Close().

Beachten Sie, dass die Implementierung dieser Methode aufgrund von abwärts Kompatibilitätsanforderungen von der empfohlenen Anleitung für das Lösch Muster abweicht.Note that because of backward compatibility requirements, this method's implementation differs from the recommended guidance for the Dispose pattern. Diese Methode ruft Close()auf, wodurch aufgerufen Dispose(Boolean)wird.This method calls Close(), which then calls Dispose(Boolean).

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Stream verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Stream and optionally releases the managed resources.

protected:
 virtual void Dispose(bool disposing);
protected virtual void Dispose (bool disposing);
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
Protected Overridable Sub Dispose (disposing As Boolean)

Parameter

disposing
Boolean Boolean Boolean Boolean

true, um sowohl verwaltete als auch nicht verwaltete Ressourcen freizugeben, false, um ausschließlich nicht verwaltete Ressourcen freizugeben.true to release both managed and unmanaged resources; false to release only unmanaged resources.

Hinweise

Sie sollten alle Ressourcen freigeben, indem true Sie disposingfür angeben.You should release all resources by specifying true for disposing. Wenn disposingden Wert hat,kannderStreamauchsicherstellen,dassDatenindenzugrundeliegendenPuffergeleertwerden,undaufanderefinalisierbareObjektezugreifen.trueWhen disposing is true, the stream can also ensure data is flushed to the underlying buffer, and access other finalizable objects. Dies ist möglicherweise nicht möglich, wenn der Aufruf von einem Finalizer aufgrund fehlender Reihenfolge zwischen Finalizern erfolgt.This may not be possible when called from a finalizer due a lack of ordering among finalizers.

Wenn Ihr Stream ein Betriebssystem Handle für die Kommunikation mit seiner Quelle verwendet, sollten Sie zu diesem Zweck eine SafeHandle Unterklasse von verwenden.If your stream is using an operating system handle to communicate with its source, consider using a subclass of SafeHandle for this purpose.

Diese Methode wird von der öffentlichen Dispose -Methode und der Finalize -Methode aufgerufen.This method is called by the public Dispose method and the Finalize method. DisposeRuft die geschützte Dispose Methode auf, disposing wobei der- trueParameter auf festgelegt ist.Dispose invokes the protected Dispose method with the disposing parameter set to true. FinalizeRuft Dispose auf disposing , wobei falseauf gesetzt ist.Finalize invokes Dispose with disposing set to false.

Hinweise für Vererber

Überschreiben Sie die Close() -Methode in abgeleiteten Klassen nicht, sondern fügen Sie stattdessen die gesamte streambereinigungs Logik in die Dispose(Boolean) -Methode ein.In derived classes, do not override the Close() method, instead, put all of the Stream cleanup logic in the Dispose(Boolean) method.

Dispose() kann von anderen Objekten mehrmals aufgerufen werden.Dispose() can be called multiple times by other objects. Beim Überschreiben von Dispose(Boolean) müssen Sie darauf achten, nicht auf Objekte zu verweisen, die durch einen früheren Aufruf von Dispose() freigegeben wurden.When overriding Dispose(Boolean), be careful not to reference objects that have been previously disposed of in an earlier call to Dispose(). Weitere Informationen zum Implementieren Dispose(Boolean)von finden Sie unter Implementieren einerverwerfen-Methode.For more information about how to implement Dispose(Boolean), see Implementing a Dispose Method.

Weitere Informationen zu und Dispose() Finalize()finden Sie unter Bereinigen von nicht verwalteten Ressourcen.For more information about Dispose() and Finalize(), see Cleaning Up Unmanaged Resources.

Gilt für: