ConnectionString Property (ADO)

Microsoft ActiveX Data Objects (ADO)

ADO 2.5 API Reference

ConnectionString Property

Indicates the information used to establish a connection to a data source.

Settings and Return Values

Sets or returns a String value.

Remarks

Use the ConnectionString property to specify a data source by passing a detailed connection string containing a series of argument = value statements separated by semicolons.

ADO supports five arguments for the ConnectionString property; any other arguments pass directly to the provider without any processing by ADO. The arguments ADO supports are as follows.

Argument Description
Provider= Specifies the name of a provider to use for the connection.
File Name= Specifies the name of a provider-specific file (for example, a persisted data source object) containing preset connection information.
Remote Provider= Specifies the name of a provider to use when opening a client-side connection. (Remote Data Service only.)
Remote Server= Specifies the path name of the server to use when opening a client-side connection. (Remote Data Service only.)
URL= Specifies the connection string as an absolute URL identifying a resource, such as a file or directory.

After you set the ConnectionString property and open the Connection object, the provider may alter the contents of the property, for example, by mapping the ADO-defined argument names to their provider equivalents.

The ConnectionString property automatically inherits the value used for the ConnectionString argument of the Open method, so you can override the current ConnectionString property during the Open method call.

Because the File Name argument causes ADO to load the associated provider, you cannot pass both the Provider and File Name arguments.

The ConnectionString property is read/write when the connection is closed and read-only when it is open.

Duplicates of an argument in the ConnectionString property are ignored. The last instance of any argument is used.

Remote Data Service Usage   When used on a client-side Connection object, the ConnectionString property can include only the Remote Provider and Remote Server parameters.

See Also

Visual Basic Example | Visual C++ Example | Visual J++ Example

Appendix A: Providers

Applies To: Connection Object

© 1998-2003 Microsoft Corporation. All rights reserved.