Property Element
The Property element is used to return the property from the current ForEach context. When a view or field is selected, the Property element can be used to retrieve a specific attribute value from it.
Syntax
<Property
AutoHyperLink = "TRUE" | "FALSE"
AutoNewLine = "TRUE" | "FALSE"
HTMLEncode = "TRUE" | "FALSE"
Select = "Text"
URLEncodeAsURL = "TRUE" | "FALSE">
</Property>
Attributes
| Name | Description |
|---|---|
| AutoHyperLink | Optional Boolean. TRUE if <A> tags are added to text if it looks like a hyperlink. |
| AutoNewLine | Optional Boolean. TRUE if <BR> tags are inserted into the text stream and multiple spaces are replaced with non-breaking spaces. |
| HTMLEncode | Optional Boolean. Converts embedded characters so that they are displayed as text in the browser. In other words, characters that could be confused with HTML tags are converted to entities. |
| Select | Required Text. Specifies the name of property to select. |
| URLEncodeAsURL | Optional Boolean. When TRUE, converts special characters, such as spaces, to quoted UTF-8 format (for example, %c3%ab for character ) if what is being encoded is a path component of a URL. |
Related Elements
| Parent Elements |
|---|
| Case, Default, Else, Expr, Expr1, Expr2, Fields, ForEach, Limit, RenderPattern, ScriptQuote, SetVar, Then |
Remarks
The following line, <ows:Property Select="."/>, returns the body of the element in the schema that is being enumerated. For example, within a ForEach statement such as <ForEach Select="CHOICES/CHOICE">, specifying <Property Select="."/> would return the text of one of the conditionals.
If a property cannot be found, a subelement of the current element in the schema enumeration is evaluated whose name is equal to the text specified by Select. For example, if a Field element has no property called Default, then <Property Select="Default"/> will also search for a subelement called Default and render its body text if found.
Example
The following line of code returns the Name property from the current field or view.
<Property Select="Name"/>