Elemento SetList (Vista)
Última modificación: viernes, 30 de mayo de 2008
Hace referencia a: SharePoint Foundation 2010
En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones
Designa qué lista es actual.
<SetList
Name = "Text"
PreserveContext = "TRUE" | "FALSE"
Scope = "Request">
</SetList>
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 primarios
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 tanto un formulario distribuido como uno no distribuido, de modo que <SetList>Announcements</SetList> sería igual que <SetList Name="Announcements"/>.
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>