WeakReference Constructor (Object, Boolean) (System)

Switch View

WeakReference Constructor (Object, ...

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

WeakReference Constructor (Object, Boolean)

Initializes a new instance of the WeakReference class, referencing the specified object and using the specified resurrection tracking.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

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

Visual Basic (Usage)

Dim target As Object
Dim trackResurrection As Boolean

Dim instance As New WeakReference(target, _
    trackResurrection)

public WeakReference(
    Object target,
    bool trackResurrection
)

Visual C++

public:
WeakReference(
    Object^ target, 
    bool trackResurrection
)

JScript

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

Parameters

target: Type: System..::.Object
An object to track.

trackResurrection: Type: System..::.Boolean
Indicates when to stop tracking the object. If true, the object is tracked after finalization; if false, the object is only tracked until finalization.

Remarks

If trackResurrection is false, a short weak reference is created. If trackResurrection is true, a long weak reference is created.

Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE Platform Note:

Short weak references are supported on the .NET Compact Framework, but long weak references are not supported. When you use this method, you must set the trackResurrection parameter to false.

Examples

The following example creates a cache of data objects with short weak references. This example is part of a larger example provided for the WeakReference class.

Visual Basic

' Add data objects with a short
' weak reference to the cache.
Dim i As Integer = 0
Do While (i < count)
    _cache.Add(i, New WeakReference(New Data(i)))
    i = (i + 1)
Loop

 // Add data objects with a 
 // short weak reference to the cache.
for (int i = 0; i < count; i++)
 {
     _cache.Add(i, new WeakReference(new Data(i), false));
 }

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference

WeakReference Class

WeakReference Members

WeakReference Overload

Other Resources

Weak References