Elemento SetList (Vista)
Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Designa qué lista es actual.
<SetList
Name = "Text"
PreserveContext = "TRUE" | "FALSE"
Scope = "Request">
</SetList>
Elementos y atributos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
| Name |
Text obligatorio. Especifica el nombre de la lista. |
| PreserveContext |
Boolean opcional. Si su valor es FALSE, la implementación del elemento SetList vuelve a ejecutar la consulta de base de datos necesaria para recuperar los datos y que un formulario muestre un único elemento de lista. Esta funcionalidad resulta útil cuando una vista y un formulario están en la misma página. El valor predeterminado es TRUE. |
| Scope |
Cuando se establece en Request, este atributo hace que la lista esté disponible globalmente para la página. |
Elementos secundarios
Ninguno
Elementos principales
Repeticiones
- Mínimo: 0
- Máximo: 1
Comentarios
Cuando se usa el elemento SetList, tiene que usar el nombre interno, que no tiene espacios y es invariable.
El elemento SetList tiene un formato de expansión y un formulario sin formato, por lo que sería igual <SetList Name="Announcements"/>que <SetList>Announcements</SetList> .
El elemento SetList suele ser un elemento secundario de un elemento Method usado en el procesamiento por lotes de solicitudes.
Ejemplo
El ejemplo siguiente devuelve el valor del campo Title de la tabla de listas en la base de datos si la lista actual es igual a la lista que se busca. Inicialmente, la lista actual se asigna temporalmente a una variable Old y, a continuación, se restablece como la lista actual.
<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>