WeakReference.Target プロパティ

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

WeakReference.cs

現在の WeakReference オブジェクトが参照するオブジェクト (ターゲット) を取得または設定します。

C#

public virtual object? Target { get; set; }

プロパティ値

Object

現在の WeakReference オブジェクトが参照するオブジェクトが、ガベージ コレクションで既に収集されている場合は null。それ以外の場合は、現在の WeakReference オブジェクトが参照するオブジェクトへの参照。

例外

InvalidOperationException

ターゲット オブジェクトへの参照が無効です。 この例外は、値が null 参照の場合か、設定操作中にオブジェクトが終了した場合に、このプロパティを設定するときにスローされます。

例

次の例では、弱い参照を持つオブジェクトのキャッシュからオブジェクトを取得しようとします。 オブジェクトがガベージ コレクション用に再利用された場合は、新しいオブジェクトが生成されます。 この例は、 クラスに対して提供されるより大きな例の WeakReference 一部です。

C#

Data d = _cache[index].Target as Data;
if (d == null) {
    // If the object was reclaimed, generate a new one.
    Console.WriteLine("Regenerate object at {0}: Yes", index);
    d = new Data(index);
    _cache[index].Target = d;
    regenCount++;
}
else {
    // Object was obtained with the weak reference.
    Console.WriteLine("Regenerate object at {0}: No", index);
}

return d;

注釈

このプロパティをターゲット オブジェクトに設定した後、オブジェクトへの他の厳密な参照がないことを確認します。それ以外の場合、収集されません。

適用対象

こちらもご覧ください

• Object
• GC
• 弱い参照