[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

unloads a specific object from the db4o reference mechanism.

Namespace: Db4objects.Db4o.Ext
Assembly:   Db4objects.Db4o (in Db4objects.Db4o.dll)

Syntax

Visual Basic (Declaration)
Sub Purge ( _
	obj As Object _
)
C#
void Purge (
	Object obj
)
Visual C++
void Purge (
	Object^ obj
)

Parameters

obj
System.Object
the object to be removed from the reference mechanism.

Remarks

unloads a specific object from the db4o reference mechanism.

db4o keeps references to all newly stored and instantiated objects in memory, to be able to manage object identities.

With calls to this method it is possible to remove an object from the reference mechanism, to allow it to be garbage collected. You are not required to call this method in the .NET and JDK 1.2 versions, since objects are referred to by weak references and garbage collection happens automatically.

An object removed with
 Copy imageCopy Code
purge(Object)
is not "known" to the
 Copy imageCopy Code
ObjectContainer
afterwards, so this method may also be used to create multiple copies of objects.

 Copy imageCopy Code
purge(Object)
has no influence on the persistence state of objects. "Purged" objects can be reretrieved with queries.