SafeHandle.ReleaseHandle Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборки:

netstandard.dll, System.Runtime.dll

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

SafeHandle.cs

При переопределении в производном классе выполняет код, необходимый для освобождения дескриптора.

protected:
 abstract bool ReleaseHandle();

protected abstract bool ReleaseHandle();

abstract member ReleaseHandle : unit -> bool

Protected MustOverride Function ReleaseHandle () As Boolean

Возвращаемое значение

Boolean

Значение . В этом случае он создает помощник по отладке managed DebuggingHandleFailed .

Примеры

В следующем примере кода дескриптор освобождается и является частью более крупного примера, предоставленного для SafeHandle класса.

[ReliabilityContract(Consistency.WillNotCorruptState, Cer.MayFail)]
override protected bool ReleaseHandle()
{
    // Here, we must obey all rules for constrained execution regions.
    return NativeMethods.CloseHandle(handle);
    // If ReleaseHandle failed, it can be reported via the
    // "releaseHandleFailed" managed debugging assistant (MDA).  This
    // MDA is disabled by default, but can be enabled in a debugger
    // or during testing to diagnose handle corruption problems.
    // We do not throw an exception because most code could not recover
    // from the problem.
}

Комментарии

Метод ReleaseHandle гарантированно вызывается только один раз и только в том случае, если дескриптор является допустимым, как определено свойством IsInvalid . Реализуйте этот метод в SafeHandle производных классах для выполнения любого кода, необходимого для освобождения дескриптора. Поскольку одна из функций SafeHandle заключается в обеспечении предотвращения утечки ресурсов, код в реализации ReleaseHandle не должен завершать ошибку. Сборщик мусора вызывается ReleaseHandle после выполнения обычных методов завершения для объектов, собранных мусором одновременно. Сборщик мусора гарантирует ресурсы для вызова этого метода и что метод не будет прерван во время выполнения.

Кроме того, для простой очистки (например, вызова API CloseHandle Windows в дескрипторе файла) можно проверить возвращаемое значение для вызова одной платформы. Для сложной очистки может потребоваться много логики программы и многие вызовы методов, некоторые из которых могут завершиться ошибкой. Необходимо убедиться, что в логике программы есть резервный код для каждого из этих случаев.

Если ReleaseHandle возвращается false по какой-либо причине, он создает помощник по управляемой отладке releaseHandleFailed при запуске в .NET Framework. Это помогает обнаруживать случаи, когда попытка освободить ресурсы завершается ошибкой.

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

• Диагностика ошибок во время выполнения с помощью помощников по управляемой отладке
• ReleaseHandleFailed