RetrieveNode Method (McDBDatabase)
      
 

Description

Return an McDBNode in this McDBDatabase with a given global specifier.

Return Type

A McDBNode object.  

Syntax

object.RetrieveNode (IdorPath)

The RetrieveNode Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDBDatabase.
IdorPathRequired. A String value.

The specifier, either an McDBNode.Id or McDBNode.Path. This value may either be of global form (i.e. including a database specifier) or local to this McDBDatabase. If a global specifier indicates a different database, this method returns Nothing. A path must be of an absolute form relative to the database (i.e. the path must begin at the McDBDDatabase.RootNode, \).

Remarks

If the parameter global specifier is invalid or indicates a different McDBDatabase, this method returns Nothing. This method is largely equivalent to using McDBDatabase.RootNode.Children.Item. The significant distinction is that this method will successfully return any node in a secure database to which the logged user has access (even if the logged user does NOT have access to the root node or intermediate McDBNode instance(s)) whereas, in such a secure database, the RootNode.Children is unavailable.

Notes

This method can be used to retrieve attribute McDBNode instances directly, rather than requiring the owning McDBNode to be instantiated and its McDBNode.Attributes collection be searched. Attribute McDBNode instances may only be retrieved by Id.