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