DependentHandle Структура

Определение

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

System.Runtime

Сборка:

System.Runtime.dll

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

DependentHandle.cs

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

public value class DependentHandle : IDisposable

public struct DependentHandle : IDisposable

type DependentHandle = struct
    interface IDisposable

Public Structure DependentHandle
Implements IDisposable

Наследование

Object

ValueType

DependentHandle

Реализации

IDisposable

Комментарии

Значение DependentHandle с заданным экземпляром объекта в качестве целевого объекта не приведет к тому, что целевой объект будет поддерживаться в активном состоянии, если на него нет других строгих ссылок, но оно будет делать это для зависимого экземпляра объекта, пока целевой объект находится в активном состоянии.

Использование этого типа концептуально эквивалентно слабой ссылке на данный экземпляр целевого объекта A, при этом этот объект имеет поле или свойство (или какую-либо другую строговую ссылку) на экземпляр зависимого объекта B.

Тип DependentHandle не является потокобезопасными, и потребители отвечают за то, чтобы Dispose() он не вызывался одновременно с другими API. Отсутствие этого действия приводит к неопределенному поведению.

Свойства IsAllocated, Target, Dependentи TargetAndDependent являются потокобезопасными и безопасными для использования, если Dispose() не вызывается одновременно.

Конструкторы

DependentHandle(Object, Object)

Инициализирует новый экземпляр DependentHandle структуры с указанными аргументами.

Свойства

Dependent	Возвращает или задает экземпляр зависимого объекта для текущего дескриптора.
IsAllocated	Возвращает значение, указывающее, был ли этот экземпляр создан с помощью DependentHandle(Object, Object) и еще не удален.
Target	Возвращает или задает экземпляр целевого объекта для текущего дескриптора. Целевому объекту null можно задать значение только после DependentHandle создания экземпляра. Это приведет Dependent к тому, что также начнется возврат null и станет доступным для сбора, даже если предыдущий целевой объект еще жив.
TargetAndDependent	Возвращает значения и TargetDependent (если они доступны) в виде атомарной операции. То есть, даже если Target для одновременно задано значение null, вызов этого метода будет либо возвращать null для целевого и зависимого значения, либо возвращать оба предыдущих значения. Если Target бы и Dependent использовались последовательно в этом сценарии, иногда можно было бы успешно получить предыдущий целевой объект, но затем не получить зависимый объект.

Методы

Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.