Repository Object

A Repository object is an instance of a single repository session. The scope of a repository object is a repository database. Because you can have multiple repository databases, you use the Repository object to connect and interact with a specific database.

When to Use

You can use a repository instance to:

• Create a new repository database or connect to an existing repository database.
  
  
• Access the root repository object, ReposRoot.
  
  
• Retrieve a RepositoryObject or RepositoryObjectVersion.
  
  
• Create the initial version of a RepositoryObject or RepositoryObjectVersion.
  
  
• Refresh cached repository data.
  
  
• Manage repository transactions.

Properties

Property	Description
ConnectionString	The ODBC connection string that the repository engine uses to obtain an ODBC connection. This property is not a default interface member.
MajorDBVersion	The major version number of the first repository engine version that introduced this database format. This property is not a default interface member.
MinorDBVersion	The minor version number of the first repository engine version that introduced this database format. This property is not a default interface member.
Object	Retrieves the specified RepositoryObject.
ReposConnection	The ODBC connection handle that the repository engine uses to access the repository database. This property is not a default interface member.
RootObject	The ReposRoot object of the open repository database.
Transaction	The transaction processing interface.
Version	Retrieves the specified RepositoryObjectVersion.

Methods

Method	Description
Create	Creates a new repository database.
CreateObject	Creates a new instance of a RepositoryObject or RepositoryObjectVersion in the open repository database.
CreateObjectEx	Creates the first version of a new repository object instance of the specified type and explicitly assigns the object-version identifier that is passed in as an argument. This is unlike CreateObject method, in which the repository engine assigns the version ID.
ExecuteQuery	Executes an SQL query against the repository database. This method is not a default interface member.
FreeConnection	Releases an ODBC connection handle. This method is not a default interface member.
GetCollection	Returns a result set of objects in a collection based on selection criteria.
GetNewConnection	Obtains a new ODBC connection handle using the same connection settings that the repository engine is using to access the repository database. This method is not a default interface member.
GetOption	Gets an option that supports performance optimization at run time.
InternalIDToObjectID	Converts an internal identifier into an object identifier.
InternalIDToVersionID	Converts an internal object-version identifier into an object-version identifier.
ObjectIDToInternalID	Converts an object identifier into an internal identifier.
Open	Opens the specified repository database.
Refresh	Refreshes the cached image of all data for the open repository database.
ResetOption	Resets a run-time performance option to its default value.
SetOption	Sets an option that supports performance optimization at run time.
VersionIDToInternalID	Converts an object-version identifier into an internal object-version identifier.

See Also

Connecting to and Configuring a Repository