weak reference

.NET Framework クラス ライブラリ リファレンス

WeakReference クラス

"弱い参照" を表します。弱い参照は、オブジェクトがガベージ コレクションの対象になっている状態のままで、そのオブジェクトを参照します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class WeakReference
    Implements ISerializable

Visual Basic (使用法)

Dim instance As WeakReference

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class WeakReference : ISerializable

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class WeakReference : ISerializable

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class WeakReference implements ISerializable

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class WeakReference implements ISerializable

解説

共通言語ランタイムのガベージ コレクションの機構は、アクセスできないオブジェクトをメモリからクリアします。オブジェクトの参照が null 参照 (Visual Basic では Nothing) に設定された場合など、直接、間接を問わずオブジェクトへのすべての参照が無効になると、そのオブジェクトにはアクセスできなくなります。アクセス可能なオブジェクトへの参照は、"強い参照" と呼ばれます。

弱い参照でも、アクセス可能なオブジェクトを参照します。このようなオブジェクトはターゲットと呼ばれます。ユーザーがターゲットへの強い参照を作成するには、Target プロパティの値を変数に割り当てます。ただし、強い参照で参照されないターゲットは、弱い参照で参照されていてもガベージ コレクションの対象になります。

オブジェクトがガベージ コレクションの対象になる時点と、このオブジェクトが収集される時点との間に遅延が生じることがあります。ターゲットの収集後に、ユーザーがそのターゲットを取得しようとした場合、null 参照だけが取得されます。ターゲットがまだ収集されていない場合には、有効な参照を取得できます。

Finalize メソッドが存在し、さらにこのメソッドを呼び出すように指示されている場合には、ガベージ コレクションは、オブジェクトに対してこのメソッドを呼び出します。つまり、終了処理が実行されます。終了処理が完了した後に、ユーザーが現在の WeakReference オブジェクトの IsAlive プロパティまたは Target プロパティを使用してオブジェクトにアクセスしようとすると、InvalidOperationException がスローされます。

用語

オブジェクトとガベージ コレクションを記述する際に使用するいくつかの専門用語を知っておくと役立ちます。アクセス可能で使用できるオブジェクトは、生きている状態のオブジェクトです。未使用でガベージ コレクションの対象となるオブジェクトは、死んでいる状態のオブジェクトです。死んでいる状態のオブジェクトへの強い参照が取得されると、そのオブジェクトは再び生きている状態になります。このオブジェクトは再生したことになります。

WeakReference オブジェクトは、終了後にターゲットへの参照を維持するかどうか、つまり、弱い参照によりターゲットの再生を追跡するかどうかを指定できます。再生を追跡しない弱い参照は、"短い弱い参照" と呼ばれます。再生を追跡する弱い参照は、"長い弱い参照" と呼ばれます。

パフォーマンスに関する考慮事項

WeakReference オブジェクトのキャッシュに、アプリケーションで使用されるオブジェクトのセットへの参照が維持されるコード例で、WeakReference クラスがよく使用されます。たとえば、オブジェクトがスコープ外であるために死んだ状態になった場合でも、ガベージ コレクション機構は割り当てられたメモリをクリアできます。

この例を使用して優れたメモリ管理スキームについて説明した場合、誤解を招く可能性があります。WeakReference クラスをメモリ管理の問題に対する自動的な解決策として扱うことができないためです。キャッシュで保有または削除するエントリについて、アプリケーションの規則、つまりキャッシュ ポリシーを確立する必要があります。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。要求値 : InheritanceDemand; アクセス許可値 : UnmanagedCode

継承階層

System.Object
  System.WeakReference

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WeakReference メンバ
System 名前空間
GC クラス

WeakReference コンストラクタ (Object, Boolean)

指定したオブジェクトを参照し、指定した再生処理追跡を使用する WeakReference クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    target As Object, _
    trackResurrection As Boolean _
)

Visual Basic (使用法)

Dim target As Object
Dim trackResurrection As Boolean

Dim instance As New WeakReference(target,
 trackResurrection)

C#

public WeakReference (
    Object target,
    bool trackResurrection
)

C++

public:
WeakReference (
    Object^ target, 
    bool trackResurrection
)

J#

public WeakReference (
    Object target, 
    boolean trackResurrection
)

JScript

public function WeakReference (
    target : Object, 
    trackResurrection : boolean
)

パラメータ

target

追跡するオブジェクト。

trackResurrection

オブジェクト追跡の停止時期を示します。true を設定すると、終了後にオブジェクトが追跡されます。false を設定すると、オブジェクトの追跡は終了が実行される時点で停止します。

解説

trackResurrection が false の場合は短い弱い参照が作成されます。trackResurrection が true の場合は長い弱い参照が作成されます。通常、短い弱い参照だけが必要です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WeakReference クラス
WeakReference メンバ
System 名前空間
Object クラス
Boolean 構造体
GCHandle

WeakReference コンストラクタ

WeakReference クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
WeakReference (Object)	指定したオブジェクトを参照する、WeakReference クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
WeakReference (Object, Boolean)	指定したオブジェクトを参照し、指定した再生処理追跡を使用する WeakReference クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
WeakReference (SerializationInfo, StreamingContext)	指定したシリアル化およびストリーム オブジェクトからの逆シリアル化されたデータを使用して、WeakReference クラスの新しいインスタンスを初期化します。

参照

関連項目

WeakReference クラス
WeakReference メンバ
System 名前空間
Object クラス

WeakReference コンストラクタ (SerializationInfo, StreamingContext)

指定したシリアル化およびストリーム オブジェクトからの逆シリアル化されたデータを使用して、WeakReference クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    info As SerializationInfo, _
    context As StreamingContext _
)

Visual Basic (使用法)

Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New WeakReference(info,
 context)

C#

protected WeakReference (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
WeakReference (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected WeakReference (
    SerializationInfo info, 
    StreamingContext context
)

JScript

protected function WeakReference (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

現在の WeakReference オブジェクトのシリアル化または逆シリアル化に必要なすべてのデータを保持するオブジェクト。

context

(予約済み) info によって指定されたシリアル化ストリームの転送元と転送先の説明。

例外

例外の種類	条件
ArgumentNullException	info が null 参照 (Visual Basic では Nothing) です。

解説

context パラメータは予約されているため、この操作では使用されません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WeakReference クラス
WeakReference メンバ
System 名前空間

WeakReference コンストラクタ (Object)

指定したオブジェクトを参照する、WeakReference クラスの新しいインスタンスを初期化します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    target As Object _
)

Visual Basic (使用法)

Dim target As Object

Dim instance As New WeakReference(target)

C#

public WeakReference (
    Object target
)

C++

public:
WeakReference (
    Object^ target
)

J#

public WeakReference (
    Object target
)

JScript

public function WeakReference (
    target : Object
)

パラメータ

target

追跡するオブジェクトまたは null 参照 (Visual Basic では Nothing)。

解説

このコンストラクタは、target への短い弱い参照を作成します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WeakReference クラス
WeakReference メンバ
System 名前空間
Object クラス

WeakReference プロパティ

パブリック プロパティ

	名前	説明
	TrackResurrection	現在の WeakReference オブジェクトが参照するオブジェクトを、その終了後に追跡するかどうかを示す値を取得します。

参照

関連項目

WeakReference クラス
System 名前空間
GC クラス

WeakReference メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	SerializationInfo オブジェクトに、現在の WeakReference オブジェクトをシリアル化するために必要なすべてのデータを格納します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	オーバーライドされます。 現在の WeakReference オブジェクトが表すターゲットへの参照を破棄します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

WeakReference クラス
System 名前空間
GC クラス

WeakReference メンバ

"弱い参照" を表します。弱い参照は、オブジェクトがガベージ コレクションの対象になっている状態のままで、そのオブジェクトを参照します。

WeakReference データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

( プロテクト コンストラクタ も参照)

	名前	説明
	WeakReference	オーバーロードされます。 WeakReference クラスの新しいインスタンスを初期化します。

プロテクト コンストラクタ

	名前	説明
	WeakReference	オーバーロードされます。 WeakReference クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	TrackResurrection	現在の WeakReference オブジェクトが参照するオブジェクトを、その終了後に追跡するかどうかを示す値を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	SerializationInfo オブジェクトに、現在の WeakReference オブジェクトをシリアル化するために必要なすべてのデータを格納します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	オーバーライドされます。 現在の WeakReference オブジェクトが表すターゲットへの参照を破棄します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

WeakReference クラス
System 名前空間
GC クラス