CopyForAnotherThread Class

Enables copying of IThreadAware objects for use in another thread.

Inheritance Hierarchy

System.Object
AGI.Foundation.Infrastructure.CopyContext
AGI.Foundation.Infrastructure.CopyForAnotherThread

Namespace: AGI.Foundation.Infrastructure
Assembly: AGI.Foundation.Core (in AGI.Foundation.Core.dll) Version: 25.1.421.0 (25.1.421.0)

Syntax

C++

Copy

public class CopyForAnotherThread : CopyContext

Public Class CopyForAnotherThread
	Inherits CopyContext

public ref class CopyForAnotherThread : public CopyContext

type CopyForAnotherThread =  
    class
        inherit CopyContext
    end

The CopyForAnotherThread type exposes the following members.

Constructors

	Name	Description
	CopyForAnotherThread	Initializes a new instance of the CopyForAnotherThread class

Top

Methods

	Name	Description
	AddObjectMapping<T>	Adds a mapping between an old object reference and a new one. The default implementation of UpdateReference<T> (T) will substitute newObject everywhere it encounters oldObject. (Inherited from CopyContext.)
	ClearObjectMapping	Clears the list of mappings that has been created with calls to AddObjectMapping<T>(T, T). This is useful if you want to reuse a CopyContext instance for a separate copy operation. (Inherited from CopyContext.)
	Clone<T>	Copies the specified object using the ICloneWithContext interface or the ICloneable interface, with a preference on ICloneWithContext. (Inherited from CopyContext.)
	CloneIfNotMapped<T>	Looks for a mapping for this object that was added with AddObjectMapping<T>(T, T). If one is found, the object to which the specified one is mapped is returned. If one is not found, this method clones the given object by calling Clone<T>(T). Derived classes can override this default behavior. (Inherited from CopyContext.)
	Copy<T>	Copies an object for use in another thread.
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetObjectMapping<T>	Gets the mapping for the specified object. (Inherited from CopyContext.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	UpdateReference<T>	Updates a given reference, returning a reference to use in its place. (Overrides CopyContext.UpdateReference<T>(T).)

Top

Examples

The following example shows how to use this class to create a copy of an object that can be used simultaneously with the original from another thread:

Copy

// An object that we need to copy for another thread. In this case, we are 
// copying an evaluator. 
AxesEvaluator axesEvaluator = GeometryTransformer.GetAxesTransformation(fromAxes, toAxes);

// Call the static Copy method.
AxesEvaluator copiedEvaluator = CopyForAnotherThread.Copy(axesEvaluator);

Reference

AGI.Foundation.Infrastructure Namespace