ChangeMonitor.Dispose Methode

public:
 virtual void Dispose();

public void Dispose();

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

Public Sub Dispose ()

Implementeringen

Uitzonderingen

Opmerkingen

De Dispose methode roept de Dispose methode van afgeleide klassen slechts één keer aan, de eerste keer dat deze wordt aangeroepen. Volgende aanroepen naar de Dispose methode hebben geen effect. Nadat de methode is aangeroepen, wordt de IsDisposed eigenschap ingesteld op true.

De Dispose overbelasting moet worden aangeroepen om een ChangeMonitor exemplaar te verwijderen. Hier volgen de regels voor het aanroepen van de verwijderingsmethode:

• Voordat een item in de cache wordt ingevoegd, is het de verantwoordelijkheid van de aanroeper om een ChangeMonitor exemplaar te verwijderen.

• Zodra het cache-item en de ChangeMonitor exemplaren die eraan zijn gekoppeld, worden doorgegeven aan een cache, moet de cache-implementeerfunctie die moet worden Dispose aangeroepen, zelfs als de invoegbewerking mislukt.

• Nadat een item en de bijbehorende ChangeMonitor exemplaren zijn doorgegeven aan een cache, mag de aanroeper de afhankelijkheid niet verwijderen omdat wanneer de Dispose methode wordt aangeroepen, de aanroep wordt behandeld alsof de afhankelijkheid is gewijzigd. Hierdoor wordt de OnChanged methode automatisch aangeroepen.

• Als u rekening houdt met deze regels, moet de Dispose methode op een van de volgende manieren worden aangeroepen:

  • Gebruikers moeten de overbelasting van de Dispose methode aanroepen als ze besluiten het afgeleide exemplaar van wijzigingsmonitor niet in een cache in te voegen.

  • De cache-implementatie is verantwoordelijk voor het aanroepen van de Dispose overbelasting als de implementatie probeert het exemplaar van wijzigingsmonitor in te voegen in een objectcache, maar de invoegbewerking mislukt. Wanneer de invoegpoging een uitzondering veroorzaakt, moet de cache-implementatie alle bijbehorende afhankelijkheden verwijderen.

  • Als de cachevermelding wordt verwijderd, moet de cache-implementatie ook de afhankelijkheid verwijderen.

De interne implementatie van de OnChanged methode roept automatisch de Dispose methode aan nadat deze een callback heeft aangeroepen die via de NotifyOnChanged methode is geregistreerd.

Wanneer de constructor van een afgeleide wijzigingsmonitor de InitializationComplete methode aanroept, wordt de wijzigingsmonitor automatisch verwijderd als de status van de wijzigingsmonitor al is gewijzigd (de status die wordt bewaakt toen de constructor nog actief was).InitializationComplete

Om te voorkomen dat afgeleide klassen de methode overschrijven Dispose , is de methode geen expliciete interface-implementatie.

Zie ook

• OnChanged(Object)

protected:
 abstract void Dispose(bool disposing);

protected abstract void Dispose(bool disposing);

abstract member Dispose : bool -> unit

Protected MustOverride Sub Dispose (disposing As Boolean)

Parameters

Opmerkingen

Wanneer de waarde de waarde disposing is true, worden alle beheerde en onbeheerde resources verwijderd en worden alle verwijzingen naar dit object vrijgegeven, zodat het afgeleide exemplaar van wijzigingsmonitor garbagecollection kan worden verzameld. Het is gegarandeerd dat de basismethode Dispose slechts één keer de geïmplementeerde Dispose methode aanroept.

Notities voor uitvoerders

Een wijzigingsmonitor moet de Dispose(Boolean) overbelasting implementeren om alle beheerde en onbeheerde resources vrij te geven wanneer de waarde disposing is true. De overbelasting van de Dispose(Boolean) methode met een disposing waarde wordt true slechts één keer aangeroepen, namelijk wanneer het exemplaar voor het eerst wordt verwijderd. Een wijzigingsmonitor mag de Dispose(Boolean) overbelasting niet rechtstreeks aanroepen. Een afgeleide wijzigingsmonitor kan de openbare parameterloze Dispose() methode op de basisklasse ChangeMonitor aanroepen.

Een wijzigingsmonitor kan ook een finalizer-methode implementeren. In dat geval kan de finalizer de Dispose(Boolean) methode aanroepen en deze doorgeven aan een disposing waarde van false. Dit is echter meestal niet nodig. Bewaking voor afhankelijkheidswijzigingen wordt doorgaans uitgevoerd door een service die een verwijzing naar het exemplaar van wijzigingsmonitor onderhoudt. De verwijzing voorkomt dat het exemplaar afval wordt verzameld en maakt daarom een finalizer-methode onnodig. Om geheugenlekken te voorkomen, verwijdert de OnChanged(Object) methode, wanneer een afhankelijkheid verandert, het exemplaar van de wijzigingsmonitor (tenzij initialisatie nog niet is voltooid).