SetList-Element (View)

  • Artikel

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

Vorkommen

  • Minimum: 0
  • Maximum: 1

HinwBemerkungeneise

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