Inspectdynamicdataref() – Adobe Extending Dreamweaver CS4 User Manual
Page 308
302
EXTENDING DREAMWEAVER CS4
Data sources
•
The
name
property is the name of the server behavior that is associated with the data source, if one exists. It is a
required property. Some data sources, such as recordsets, are associated with server behaviors. When you create a
recordset and name it
rsAuthors
, the
name
property must equal
rsAuthors
. Other data sources, such as session
variables, do not have a corresponding server behavior. Their name property must be the empty string (
""
).
Note: A JavaScript class that defines these properties exists in the DataSourceClass.js file, which is located in the
Configuration/Shared/Common/Scripts folder.
inspectDynamicDataRef()
Availability
Dreamweaver UltraDev 1.
Description
This function determines the corresponding node in the data source tree from a dynamic data object. The
inspectDynamicDataRef()
function takes the string that Dreamweaver passes in and compares it to the string that
generateDynamicDataRef()
returns for each node in the tree. If a match is found, the
inspectDynamicDataRef()
function indicates which node in the tree matches the passed-in string. The function identifies the node by using an
array that contains two elements. The first element is the name of the parent node, and the second element is the name
of the child node. If no match is found, the
inspectDynamicDataRef()
function returns an empty array.
Each implementation of the
inspectDynamicDataRef()
function checks only for matches of its own object type. For
example, the recordset implementation of the
inspectDynamicDataRef()
function finds a match only if the passed-
in string matches a recordset node in the tree.
Arguments
string
•
The string argument is the dynamic data object.
Returns
Dreamweaver expects an array of two elements (parent name and child name) for the matched node; it returns a
null
value if no matches are found.