Specifications

Chapter 28340
Returns
A connection object that provides values for a particular combination of the properties that are
listed in the following table. The properties for which this function returns a value depends on
the document type.
If a connection is not found in htmlSource, a null value returns.
Note: Developers can add custom properties (for example, metadata) to the HTML source, which
applyConnection() returns along with the standard properties.
Property Description
name Name of the connection
type If useHTTP is false, indicates which DLL to use for connecting to database
at runtime
string Runtime connection string. For ADO, it is a string of connection parameters; for
JDBC, it is a connection URL
dsn Data source name used for ODBC or Cold Fusion runtime connections
driver Name of a JDBC driver used at runtime
username Name of the user used for the runtime connection
password Password used for the runtime connection
designtimeString Design-time connection string (see string)
designtimeDsn Design-time data source name (see dsn)
designtimeDriver Name of a JDBC driver used at design time
designtimeUsername Name of the user used for the design-time connection
designtimePassword Password used for the design-time connection
designtimeType Design time connection type
usesDesigntimeInfo When false, Dreamweaver uses runtime properties at design time; otherwise,
Dreamweaver uses design-time properties
useHTTP String containing either true or false; which specifies whether to use HTTP
connection at design time or use DLL
includePattern Regular expression used to find the file include statement on the page during Live
Data and Preview In Browser
variables Object with a property for each page variable which is set to its corresponding
value. This object is used during Live Data and Preview In Browser
catalog String containing a database identifier that restricts the amount of metadata
that appears
schema String containing a database identifier that restricts the amount of metadata
that appears
filename Name of the dialog box used to create the connection