Traverse Method (navigationPath)

[This is preliminary documentation and is subject to change.]

Traverses the persistent object graph from this object using a period delimited navigation path.

Declaration Syntax

public Object Traverse(
	string navigationPath
)

Parameters

navigationPath (String): The path to traverse.

Return Value

The object found at the end of the traverse, or null if any node in the traverse is null.

Remarks

The navigation path should consist of public property names. Reflection is used to access the object which is the value of the named property at each node in the traverse. In other words, assuming prop1 prop2 and prop3 are public properties, then

this.Traverse("prop1.prop2.prop3");

is equivalent to

this.prop1.prop2.prop3;

If at any point in the traverse, a node value is null, then null is returned without an exception being created.

The navigation path may start with "The" in which case the second node in the path must be "Internet", "Domain", "Environment" or any singleton class name in the running Package. In this case, this object is not used in the traverse.

Assembly: Persistate (Module: Persistate) Version: 0.6.1.20 (0.6.1.20)