DependentHandle 構造体

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

依存ガベージコレクションハンドルを表します。このハンドルは、ターゲットインスタンスへの強い参照を表すことなく、ターゲットオブジェクトインスタンスもアライブである限り、依存オブジェクトインスタンスを条件付きでアライブに維持します。

public value class DependentHandle : IDisposable

public struct DependentHandle : IDisposable

type DependentHandle = struct
    interface IDisposable

Public Structure DependentHandle
Implements IDisposable

DependentHandle指定されたオブジェクトインスタンスを target として持つ値は、ターゲットへの他の厳密な参照がない場合、ターゲットをアクティブに保つわけではありませんが、ターゲットがアクティブである限り、依存オブジェクトインスタンスに対して実行されます。

この型の使用は、概念的には、特定のターゲットオブジェクトインスタンス A への弱い参照を持ち、そのオブジェクトに依存オブジェクトインスタンス B へのフィールドまたはプロパティ (またはその他の強力な参照) を持つことと同じです。

型は DependentHandle スレッドセーフではなく、コンシューマーは、他 Dispose() の API と同時に呼び出されないようにする責任があります。これを行わないと、未定義の動作が発生します。

、IsAllocated、Dependentおよび TargetAndDependent プロパティは代わりにスレッドセーフであり、が同時に呼び出されない場合Dispose()は安全に使用できます。 Target

指定した引数を使用して DependentHandle 、構造体の新しいインスタンスを初期化します。

Dependent	現在のハンドルの依存オブジェクトインスタンスを取得または設定します。
IsAllocated	このインスタンスがで DependentHandle(Object, Object) 構築され、まだ破棄されていないかどうかを示す値を取得します。
Target	現在のハンドルのターゲットオブジェクトインスタンスを取得または設定します。ターゲットは、インスタンスが `null` 作成された後にのみ値に DependentHandle 設定できます。そうすると、 Dependent 戻りも開始 `null` され、前のターゲットがまだ生きている場合でもコレクションの対象になります。
TargetAndDependent	と Dependent (使用可能な場合) の両方Targetの値をアトミック操作として取得します。つまり、がに同時に設定`null`されている場合Targetでも、このメソッドを呼び出すと、ターゲットと依存の両方に対してが返`null`されるか、前の値の両方が返されます。 Dependentこのシナリオでとが順番に使用されている場合Targetは、前のターゲットを正常に取得できる場合がありますが、依存オブジェクトを取得できません。

アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。