SetList-Element (View)

Artikel
10/16/2024

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Legt fest, welche Liste aktuell ist.

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

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

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

Methode

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 verfügt sowohl über ein überspannendes als auch ein nichtspannendes Formular, sodass dies <SetList>Announcements</SetList> mit identisch <SetList Name="Announcements"/>wäre.

Das SetList-Element ist häufig ein untergeordnetes Element des Method-Elements, das bei der Batchverarbeitung von Anforderungen verwendet wird.

Beispiel

Im folgenden Beispiel wird der Wert des Felds Titel aus der Listen Tabelle in der Datenbank zurückgegeben, wenn die aktuelle Liste der gesuchten Liste entspricht. Zunächst wird die aktuelle Liste vorübergehend einer Variablen Old zugewiesen und dann wieder als aktuelle Liste verwendet.

<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>

Siehe auch

List-Element (List)

Freigeben über