User Guide

72 The Database API
Arguments
name
■ The name argument is a string variable that specifies the name of the connection that you
want to reference.
Returns
A reference to a named connection object. Connection objects contain the following
properties:
Property Description
name
Connection name
type
Indicates, if useHTTP is a value of false, which DLL to use for
connecting to a database at runtime
string
Runtime ADO connection string or JDBC URL
dsn
ColdFusion DSN
driver
Runtime JDBC driver
username
Runtime user name
password
Runtime password
useHTTP
String that contains either a true or false value, specifying
whether to use a remote driver (HTTP connection) at design time;
otherwise, use a local driver (DLL)
includePattern
Regular expression used to find the file include statement on the
page during Live Data and Preview In Browser
variables
Array of page variable names and their corresponding values
used during Live Data and Preview In Browser
catalog
Used to restrict the metadata that appears (for more information,
see “MMDB.getProcedures()” on page 90)
schema
Used to restrict the metadata that appears (for more information,
see “MMDB.getProcedures()” on page 90)
filename
Filename of dialog box that was used to create the connection
NOTE
These properties are the standard ones that Dreamweaver implements. Developers can
define their connection types and add new properties to this standard set or provide a
different set of properties.
000_DW_API_Print.book Page 72 Wednesday, July 20, 2005 11:58 AM