SetList-Element (View)
Letzte Änderung: Freitag, 30. Mai 2008
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Legt fest, welche Liste aktuell ist.
<SetList
Name = "Text"
PreserveContext = "TRUE" | "FALSE"
Scope = "Request">
</SetList>
Attribute
Attribut |
Beschreibung |
|---|---|
Name |
Erforderlicher Text-Wert. Gibt den Namen der Liste an. |
PreserveContext |
Optionaler Boolean-Wert. Falls FALSE, wird bei Implementierung des SetList-Elements die Datenbankabfrage erneut ausgeführt, die erforderlich ist, um Daten für ein Formular abzurufen, das ein einzelnes Listenelement anzeigt. Diese Funktionalität ist nützlich, wenn sich eine Ansicht und ein Formular auf derselben Seite befinden. Der Standardwert ist TRUE. |
Scope |
Bei Festlegung auf Request stellt dieses Attribut die Liste der Seite global zur Verfügung. |
Untergeordnete Elemente
Keine |
Übergeordnete Elemente
Vorkommen
Minimum: 0 Maximum: 1 |
Hinweise
Wenn Sie das SetList-Element angeben, müssen Sie den internen Namen verwenden, der keine Leerzeichen enthält und unveränderlich ist.
Das SetList-Element hat eine übergreifende und eine nicht übergreifende Form, sodass <SetList>Announcements</SetList> identisch mit <SetList Name="Announcements"/> ist.
Das SetList-Element ist häufig ein untergeordnetes Element des Method-Elements, das bei der Batchverarbeitung von Anforderungen verwendet wird.
Beispiel
Das folgende Beispiel gibt den Wert des Title-Felds in der Tabelle Lists in der Datenbank zurück, wenn die aktuelle Liste der nachgeschlagenen Liste entspricht. Anfänglich wird die aktuelle Liste vorübergehend der Variablen Old zugewiesen und anschließend als aktuelle Liste wiederhergestellt.
<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>