ReposRoot Object

See Also

There is one root object in each Repository. The root object is the starting point for navigating to other objects in the Repository. The root object serves as the starting point for both type and instance data navigations.

• Type data navigation

  When you create a tool information model, the corresponding Repository type library is attached to the root object through the ReposTypeLibs collection. This collection can be used to enumerate all of the tool information models (type data) that are contained in the Repository.

• Instance data navigation

  Once a tool information model is defined, the Repository can be populated with instance data. This instance data consists of objects and relationships that conform to the classes and relationship types of the tool information model.

  Because the objects are connected through relationships, you can navigate through this data. However, to enable general purpose Repository browsers to navigate this data, the first navigational step must be from the root object of the Repository through a root relationship collection to the primary objects of your tool information model. Primary objects are objects that make a good starting point for navigating to other objects of your tool information model.

  Because this root relationship collection is different for each tool information model, it must be defined by the tool information model. There are two options for attaching this relationship collection to the root object:

  1. The ReposRoot class implements the IReposRoot interface. This interface is provided to tool information model creators as a connection point. You can add your connecting relationship collection to this interface.
     
     
  2. You can extend the ReposRoot class to implement a new interface that is defined in your tool information model. This interface implements a relationship collection that attaches the root object to the primary objects in your tool information model.

To facilitate navigation, the root object in all repositories always has the same object identifier. The symbolic name for this object identifier is OBJID_ReposRootObj.

A ReposRoot object is also a RepositoryObject. In addition to the members described here, ReposRoot objects also provide the members that are defined for Repository objects.

When to Use

Use the ReposRoot object to:

• Obtain a starting point for navigating to objects in the Repository.
  
  
• Create a new tool information model.
  
  
• Attach a relationship collection to the root object of the Repository that connects to the primary objects of your tool information model.
  
  
• Determine what tool information models are currently stored in the Repository.

Methods

Collections