SafeHandle.Dispose Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Освобождение ресурсов, используемых классом SafeHandle.
Перегрузки
Dispose() |
Освобождает все ресурсы, используемые классом SafeHandle. |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые классом SafeHandle, определяя, нужно ли выполнять обычную операцию удаления. |
Dispose()
- Исходный код:
- SafeHandle.cs
- Исходный код:
- SafeHandle.cs
- Исходный код:
- SafeHandle.cs
Освобождает все ресурсы, используемые классом SafeHandle.
public:
virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()
Реализации
Комментарии
Close Вызов метода или Dispose позволяет освободить ресурсы. Это может произойти не сразу, если другие потоки используют один и тот же экземпляр безопасного дескриптора, но произойдет, как только это больше не так. Хотя в большинстве классов, использующих SafeHandle метод завершения, не требуется предоставлять метод завершения, иногда это необходимо (например, для очистки буферов файлов или записи некоторых данных обратно в память). В этом случае они могут предоставить метод завершения, который гарантированно будет выполняться до запуска критического SafeHandle метода завершения.
Close Вызовите метод или Dispose по завершении использования SafeHandle объекта . Метод Close оставляет SafeHandle объект в непригодном для использования состоянии.
Примечание
Всегда вызывайте Close метод или Dispose перед выпуском последней ссылки на SafeHandle объект . В противном случае используемые им ресурсы не будут освобождены до тех пор, пока сборщик мусора не вызовет для объекта SafeHandle метод Finalize.
Применяется к
Dispose(Boolean)
- Исходный код:
- SafeHandle.cs
- Исходный код:
- SafeHandle.cs
- Исходный код:
- SafeHandle.cs
Освобождает неуправляемые ресурсы, используемые классом SafeHandle, определяя, нужно ли выполнять обычную операцию удаления.
protected:
virtual void Dispose(bool disposing);
[System.Security.SecurityCritical]
protected virtual void Dispose (bool disposing);
protected virtual void Dispose (bool disposing);
[<System.Security.SecurityCritical>]
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
Protected Overridable Sub Dispose (disposing As Boolean)
Параметры
- disposing
- Boolean
Значение true
для обычной операции удаления и значение false
для завершения работы с дескриптором.
- Атрибуты
Комментарии
Никогда не следует явным Dispose образом вызывать метод с параметром disposing
, равным false
.