SetList Element (View)

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Designates which list is current.

<SetList
  Name = "Text"
  PreserveContext = "TRUE" | "FALSE"
  Scope = "Request">
</SetList>

Attributes

Attribute	Description
Name	Required Text. Specifies the name of the list.
PreserveContext	Optional Boolean. If FALSE, implementing the SetList element reruns the database query that is necessary to fetch the data for a form that displays a single list item. This functionality is useful when a view and a form are on the same page. The default value is TRUE.
Scope	When set to Request, this attribute makes the list globally available to the page.

Child Elements

None

Parent Elements

Method

Occurrences

Minimum: 0 Maximum: 1

Remarks

When you use the SetList element, you need to use the internal name, which has no spaces and is invariant.

The SetList element has both a spanning and a nonspanning form, so that <SetList>Announcements</SetList> would be the same as <SetList Name="Announcements"/>.

The SetList element is often a child to a Method element used in batch processing of requests.

Example

The following example returns the value of the Title field from the Lists table in the database if the current list equals the list that is looked up. Initially, the current list is temporarily assigned to a variable, Old, and then reinstated as the current list.

<SetVar Scope="Request" Name="Old">
   <List/>
</SetVar>
<SetList>
   <GetVar Name="Lookup"/>
</SetList>
<IfEqual>
   <Expr1>
      <List/>
   </Expr1>
   <Expr2>
      <GetVar Name="Lookup"/>
   </Expr2>
   <Then>
      <ListProperty HTMLEncode="TRUE" Select="Title"/>
   </Then>
</IfEqual>
<SetList><GetVar Name="Old"/></SetList>

See Also

Reference

List Element (List)