ChangeMonitor.Dispose Метод

Исходный код:

ChangeMonitor.cs

Исходный код:

ChangeMonitor.cs

Исходный код:

ChangeMonitor.cs

Исходный код:

ChangeMonitor.cs

public:
 virtual void Dispose();

public void Dispose();

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

Public Sub Dispose ()

Реализации

Исключения

Комментарии

Метод Dispose вызывает Dispose метод производных классов только один раз, при первом вызове. Последующие Dispose вызовы метода не влияют. После вызова IsDisposed метода для свойства задано trueзначение .

Перегрузка Dispose должна вызываться для удаления экземпляра ChangeMonitor . Ниже приведены правила для вызова метода dispose:

• Прежде чем элемент вставляется в кэш, он несет ответственность вызывающего объекта на удаление экземпляра ChangeMonitor .

• После того как элемент кэша и ChangeMonitor экземпляры, связанные с ним, передаются в кэш, реализующий кэш, который должен убедиться Dispose , что вызывается, даже если вставка завершается ошибкой.

• После того как элемент и связанные ChangeMonitor с ним экземпляры передаются в кэш, вызывающий объект не должен удалять зависимость, так как при Dispose вызове метода вызов вызывается так же, как если зависимость изменилась. В результате OnChanged метод вызывается автоматически.

• Учитывая эти правила, Dispose метод должен вызываться одним из следующих способов:

  • Пользователи должны вызвать перегрузку Dispose метода, если они решили не вставлять производный экземпляр монитора изменений в кэш.

  • Реализация кэша отвечает за вызов Dispose перегрузки, если реализация пытается вставить экземпляр монитора изменений в кэш объектов, но вставка завершается ошибкой. При попытке вставки возникает исключение, реализация кэша должна удалить все связанные зависимости.

  • Если запись кэша удалена, реализация кэша также должна удалить зависимость.

Внутренняя реализация OnChanged метода автоматически вызывает Dispose метод после вызова обратного вызова, зарегистрированного с помощью NotifyOnChanged метода.

Когда конструктор производного монитора изменений вызывает InitializationComplete метод, если состояние монитора изменений уже изменилось (то есть состояние, отслеживаемое уже изменилось, когда конструктор был еще активным), InitializationComplete метод будет автоматически удалять монитор изменений.

Чтобы предотвратить переопределение Dispose производных классов, метод не является явной реализацией интерфейса.

См. также раздел

• OnChanged(Object)

Исходный код:

ChangeMonitor.cs

Исходный код:

ChangeMonitor.cs

Исходный код:

ChangeMonitor.cs

Исходный код:

ChangeMonitor.cs

protected:
 abstract void Dispose(bool disposing);

protected abstract void Dispose(bool disposing);

abstract member Dispose : bool -> unit

Protected MustOverride Sub Dispose (disposing As Boolean)

Параметры

Комментарии

Если значение disposingtrueравно, все управляемые и неуправляемые ресурсы удаляются и все ссылки на этот объект освобождаются, чтобы производный экземпляр монитора изменений можно собирать мусор. Гарантируется, что базовый Dispose метод вызовет реализованный Dispose метод только один раз.

Примечания для тех, кто реализует этот метод

Монитор изменений должен реализовать перегрузкуDispose(Boolean), чтобы освободить все управляемые и неуправляемые ресурсы при значенииdisposingtrue. Перегрузка Dispose(Boolean) метода, которая disposing имеет значение true , вызывается только один раз, а именно при первом удалении экземпляра. Монитор изменений не должен вызывать перегрузку напрямую Dispose(Boolean) . Производный монитор изменений может вызывать общедоступный метод без Dispose() параметров в базовом ChangeMonitor классе.

Кроме того, монитор изменений может реализовать метод завершения. В этом случае средство завершения может вызвать Dispose(Boolean) метод и передать его disposing значение false. Однако это обычно не требуется. Мониторинг изменений зависимостей обычно выполняется службой, которая поддерживает ссылку на экземпляр монитора изменений. Ссылка предотвращает сбор мусора экземпляра и поэтому делает метод завершения ненужным. Чтобы избежать утечки памяти, при изменении OnChanged(Object) зависимостей метод удаляет экземпляр монитора изменений (если инициализация не завершена).