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, durch das Schreiben von Änderungen in den Sicherungsspeicher, und Schließen des Streams um Ressourcen freizugeben.This method disposes the stream, by writing any changes to the backing store and closing the stream to release resources.

Aufrufen von Dispose können die Ressourcen, die von verwendet die Stream , für andere Zwecke verschoben werden.Calling Dispose allows the resources used by the Stream to be reallocated for other purposes. Weitere Informationen zu Dispose, finden Sie unter Bereinigen von nicht verwalteten Ressourcen.For more information about Dispose, see Cleaning Up Unmanaged Resources.

Hinweise für Vererber

Fügen Sie alle Bereinigungslogik für das Streamobjekt in Dispose(Boolean).Place all cleanup logic for your stream object in Dispose(Boolean). Überschreiben Sie nicht Close().Do not override Close().

Beachten Sie, dass aufgrund der Abwärtskompatibilität Anforderungen, die Implementierung dieser Methode die empfohlene Vorgehensweise für das Dispose-Muster unterscheidet.Note that because of backward compatibility requirements, this method's implementation differs from the recommended guidance for the Dispose pattern. Diese Methode ruft Close(), wodurch wiederum Dispose(Boolean).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 sollte alle Ressourcen freigeben, indem Sie angeben true für disposing.You should release all resources by specifying true for disposing. Wenn disposing ist true, der Datenstrom kann auch sicherstellen, Daten in den zugrunde liegenden Puffer geleert werden, und auf andere finalisierbare Objekte zugreifen.When disposing is true, the stream can also ensure data is flushed to the underlying buffer, and access other finalizable objects. Dies kann nicht als von einem Finalizer einen Mangel an Reihenfolge der Finalizer aufgerufen möglich.This may not be possible when called from a finalizer due a lack of ordering among finalizers.

Wenn Sie Ihren Datenstrom ein Betriebssystemhandle für die Kommunikation mit der Quelle verwendet wird, erwägen Sie eine Unterklasse von SafeHandle für diesen Zweck.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 aufgerufen, von der öffentlichen Dispose Methode und die Finalize Methode.This method is called by the public Dispose method and the Finalize method. Dispose Ruft die geschützte Dispose -Methode mit dem disposing Parametersatz zu true.Dispose invokes the protected Dispose method with the disposing parameter set to true. Finalize Ruft Dispose mit disposing festgelegt false.Finalize invokes Dispose with disposing set to false.

Hinweise für Vererber

Überschreiben Sie in abgeleiteten Klassen nicht die Close() -Methode, fügen Sie stattdessen alle dem Stream Bereinigungslogik in die Dispose(Boolean) Methode.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 zur Implementierung Dispose(Boolean), finden Sie unter Implementieren einer Dispose-Methode.For more information about how to implement Dispose(Boolean), see Implementing a Dispose Method.

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

Gilt für: