Visual Basic Concepts

Initializing the rdoEngine Object

The rdoEngine object represents the remote data source and is created automatically when you first make reference to an RDO object or the RemoteData control. As the top-level object, it contains all the other objects in the hierarchy of Remote Data Objects. The rdoEngine object is predefined, therefore you can’t create additional rdoEngine objects, and it isn’t a member of any collection. You can use the rdoEngine to set data source parameters and create additional rdoEnvironment objects.

Even though the rdoEngine is shared among the various applications that use it, the rdoEngine default properties are not shared between applications. Each instance of your application is provided with its own set of default values that have no effect on other applications that also use RDO or the RemoteData control.

Note   Adding the RemoteData control to your Toolbox does not automatically set a reference to the Microsoft Remote Data Object library. To use the rdoEngine and Remote Data Objects from code, you must set a reference to the Microsoft Remote Data Object 2.0 object library in the References dialog box (available from the Projects menu); otherwise, you will get a compilation error when the first RDO object is referenced. Also, If you have Visual Basic version 4.0 or Microsoft Office installed on your computer, the RDO 1.0 library might appear in the list of object libraries exposed by the Project References dialog. While using this library is possible with Visual Basic version 5.0 or later, it is not recommended.