DependentHandle 構造体

定義

重要

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

依存ガベージコレクションハンドルを表します。ターゲットオブジェクトインスタンスへの厳密な参照を表さずに、ターゲットオブジェクトインスタンスが有効である限り、ハンドルは条件付きで依存オブジェクトインスタンスを維持します。

public value class DependentHandle : IDisposable

public struct DependentHandle : IDisposable

type DependentHandle = struct
    interface IDisposable

Public Structure DependentHandle
Implements IDisposable

特定のオブジェクトインスタンスをターゲットとして持つ DependentHandle 値は、ターゲットへの他の厳密な参照がない場合は、ターゲットを維持しませんが、ターゲットが有効である限り、依存オブジェクトインスタンスに対して有効になります。

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

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

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

名前	説明
DependentHandle(Object, Object)	指定した引数を使用して、 DependentHandle 構造体の新しいインスタンスを初期化します。

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

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

このページはお役に立ちましたか?