Updatepattern> attributes – Adobe Extending Dreamweaver CS4 User Manual

Page 281

Advertising
background image

275

EXTENDING DREAMWEAVER CS4

Server behaviors

Values
The value is a regular expression that finds a parameter between two parenthetical subexpressions, in the form /(pre-
pattern)parameter-pattern(post-pattern)/
. You need to define at least one update pattern for each unique

@@paramName@@

in the insertion text. The following example shows how your insertion text might look:

<insertText location="afterSelection">

<![CDATA[<%= @@rs@@.Field.Items("@@col@@") %>]]>

</insertText>

A particular instance of the insertion text on a page might look like the following example:

<%= RS1.Field.Items("author_id") %>

There are two parameters,

rs

and

col

. To update this text after you insert it on the page, you need two update pattern

definitions:

<updatePattern paramName="rs" >

/(\b)\w+(\.Field\.Items)/

</updatePattern>
<updatePattern paramName="col">

/(\bItems\(")\w+("\))/

</updatePattern>

The literal parentheses, as well as other special regular expression characters, are escaped by preceding them with a
backslash (\). The middle expression, defined as

\w+

, is updated with the latest value that passed in for parameters

rs

and

col

, respectively. The values

RS1

and

author_id

can be precisely updated with new values.

Multiple occurrences of the same pattern can be updated simultaneously by using the regular expression global flag

g

after the closing slash (such as /pattern/g).

If the participant text is long and complex, you might need multiple patterns to update a single parameter, as shown
in the following example:

<% ...

Recordset1.CursorType = 0;
Recordset1.CursorLocation = 2;
Recordset1.LockType = 3;

%>

To update the recordset name in all three positions, you need three update patterns for a single parameter, as shown
in the following example:

<updatePattern paramName="rs">

/(\b)\w+(\.CursorType)/

</updatePattern>
<updatePattern paramName="rs">

/(\b)\w+(\.CursorLocation)/

</updatePattern>
<updatePattern paramName="rs">

/(\b)\w+(\.LockType)/

</updatePattern>

Now you can pass in a new value for the recordset, and it is precisely updated in three locations.

<updatePattern> attributes

The following items are valid attributes of the

updatePattern

tag.

Advertising
This manual is related to the following products: