ListProperty Element
The ListProperty element returns the value of a specified column in the List of Lists table.
Syntax
<ListProperty
AutoHyperLink = "TRUE" | "FALSE"
AutoNewLine = "TRUE" | "FALSE"
Default = "Text"
HTMLEncode = "TRUE" | "FALSE"
NoURLEncode = "TRUE" | "FALSE"
Select = "Text"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</ListProperty>
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. |
| Default | Optional Text. Sets the default ProgID for the application that created the list. |
| 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. |
| NoURLEncode | Optional Boolean. FALSE if special characters, such as spaces, are converted to quoted Unicode format (e.g. %u0020). |
| Select | Required Text. Specifies a field in the List of Lists table. |
| URLEncode | Optional Boolean. When TRUE, converts special characters, such as spaces, to quoted UTF-8 format (for example, %c3%ab for character ). |
| URLEncodeAsURL | Optional Boolean. Like URLEncode, but TRUE if what is being encoded is a path component of a URL. |
Related Elements
| Parent Elements |
|---|
| Case, Default, Expr, ListFormButtons, ListFormOpening, RowLimitExceeded, ScriptQuote, SetVar, Then, Toolbar, ViewEmpty, XML |
Remarks
Use the SetList element to first specify the list you are working with.
Example
The following example returns the title and description of a list from the List of Lists table.
<ows:ListProperty Select='Title'/>
<ows:ListProperty Select='Description'/>
This example sets the Source variable to the value of the List of Lists DefaultViewUrl field if the Source variable is an empty string.
<Switch>
<Expr><GetVar Name="Source"/></Expr>
<Case Value=""><ListProperty Select="DefaultViewUrl"/></Case>
<Default><GetVar Name="Source"/></Default>
</Switch>