beautypg.com

Isoptional – Adobe Extending Dreamweaver CS4 User Manual

Page 279

background image

273

EXTENDING DREAMWEAVER CS4

Server behaviors

Values
all, attribute+attribName, tagOnly, innerOnly

The all value (default) searches the entire tag that is specified in the

whereToSearch

attribute.

The attribute+attribName value searches only within the value of the specified attribute, as shown in the following
example:

/MY_PATTERN/

This example indicates that only the value of the

ACTION

attribute of

FORM

tags should be searched. If that attribute

is not defined, the tag is ignored.

The tagOnly value searches only the outer tag and ignores the

innerHTML

tag. This value is valid only if

whereToSearch

is a tag.

The innerOnly value searches only the

innerHTML

tag and ignores the outer tag. This value is valid only if

whereToSearch

is a tag.

isOptional

Description
This attribute is a flag that indicates that the search pattern is not required to find the participant. This is useful for
complex participants that might have non-critical parameters to extract. You can create some patterns for distinctly
identifying a participant and have some optional patterns for extracting non-critical parameters.

Parent

searchPattern

Type
Attribute.

Required
No.

Values
true, false

The value is true if the

searchPattern

is not necessary to identify the participant.

The value is false (default) if the

searchPattern

tag is required.

For example, consider the following simple recordset string:

<%

var Recordset1 = Server.CreateObject("ADODB.Recordset");
Recordset1.ActiveConnection = "dsn=andescoffee;";
Recordset1.Source = "SELECT * FROM PressReleases";
Recordset1.CursorType = 3;
Recordset1.Open();
%>

This manual is related to the following products: