Stream.Dispose Methode

public:
 virtual void Dispose();

public void Dispose();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

Implementeringen

Opmerkingen

Met deze methode wordt de stream verwijderd door wijzigingen in het backing-archief te schrijven en de stream te sluiten om resources vrij te geven.

Door aanroepen Dispose kunnen de resources die door de Stream resources worden gebruikt, opnieuw worden toegewezen voor andere doeleinden. Zie Onbeheerde resources opschonen voor meer informatie.Dispose

Notities voor overnemers

Plaats alle opschoonlogica voor uw streamobject in Dispose(Boolean). Overschrijven Close()niet.

Houd er rekening mee dat vanwege compatibiliteitsvereisten voor eerdere versies de implementatie van deze methode verschilt van de aanbevolen richtlijnen voor het verwijderingspatroon. Met deze methode wordt aangeroepen, die vervolgens aanroeptClose()Dispose(Boolean).

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)

Parameters

Opmerkingen

U moet alle resources vrijgeven door op te true geven voor disposing. Wanneer disposing dat het is true, kan de stream er ook voor zorgen dat gegevens worden leeggemaakt naar de onderliggende buffer en toegang krijgen tot andere af te ronden objecten. Dit is mogelijk niet mogelijk wanneer u wordt gebeld vanuit een finalizer vanwege een gebrek aan orde tussen finalizers.

Als uw stream een besturingssysteemhandgreep gebruikt om met de bron te communiceren, kunt u overwegen een subklasse te gebruiken voor SafeHandle dit doel.

Deze methode wordt aangeroepen door de openbare Dispose() methode en de methode, als deze Finalize() is overschreven. Dispose() roept de beveiligde Dispose methode aan met de disposing parameter die is ingesteld op true. Finalize roept aan Dispose met disposing ingesteld op false.

Notities voor overnemers

In afgeleide klassen overschrijft u de Close() methode niet, in plaats daarvan plaatst u alle opschoonlogica van Stream in de Dispose(Boolean) methode.

Dispose() kan meerdere keren worden aangeroepen door andere objecten. Wees bij het Dispose(Boolean)overschrijven voorzichtig met het niet verwijzen naar objecten die eerder zijn verwijderd in een eerdere aanroep naar Dispose(). Zie Dispose(Boolean) implementeren voor meer informatie over het implementeren.

Zie Onbeheerde resources opschonen voor meer informatie over Dispose() enFinalize().