SetVar-Element (View)
Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013
Ermöglicht das Festlegen von Variablen im Renderkontext der Seite, entweder lokal für die aktuelle XML-Ebene oder global für die Seite.
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
Elemente und Attribute
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Attribute
| Attribut | Beschreibung |
|---|---|
| ID |
Optionaler Text-Wert. Stellt eine ID für die Variable bereit. |
| Name |
Erforderlicher Text-Wert. Gibt einen Namen für die Variable an. |
| Scope |
Bei Festlegung auf Request ist die Variable global. |
| Wert |
Optionaler Text-Wert. Dient zum Zuweisen eines Werts zur Variablen, wenn diese ein leeres Element ist. |
Untergeordnete Elemente
Keine
Übergeordnete Elemente
Zahlreiche
Vorkommen
- Minimum: 0
- Maximum: Unbegrenzt
HinwBemerkungeneise
Das SetVar-Element verfügt sowohl über ein überspannendes als auch ein nicht überspannendes Formular, sodass dies <SetVar Name="MyVar">Announcements</SetVar> mit identisch <SetVar Name="MyVar" Value="Announcements/>wäre.
Wenn Scope="Request" im SetVar-Element angegeben wird, erfolgt überall auf der aktuellen Seite eine Variablenzuweisung. Andernfalls betrifft die Zuweisung nur untergeordnete Elemente des SetVar-Elements.
Das SetVar-Element ist häufig ein untergeordnetes Element des Method-Elements, das bei der Batchverarbeitung von Anforderungen verwendet wird.
Das SetVar-Element wird häufig zum Ändern des Anzeigemodus verwendet, indem DisplayMode auf einen der folgenden Werte festgelegt wird.
| Wert | Beschreibung |
|---|---|
| ANZEIGEN |
Wird beim Rendern des Abschnitts ViewBody einer Ansicht verwendet. |
| BEARBEITEN |
Wird beim Rendern eines Elementbearbeitungsformulars verwendet. |
| DISPLAYHEAD |
Wird beim Rendern des Abschnitts ViewHeader einer Ansicht verwendet. |
| Neu |
Wird beim Rendern eines Formulars für neue Elemente verwendet. |
| PREVIEWDISPLAY |
Wird beim Bearbeiten eines Anzeigeformulars mit Microsoft FrontPage verwendet. |
| PREVIEWNEW |
Wird beim Bearbeiten eines Formulars für neue Elemente mit Microsoft FrontPage verwendet. |
| PREVIEWEDIT |
Wird beim Bearbeiten eines Elementbearbeitungsformulars mit Microsoft FrontPage verwendet. |
Beispiele
Das folgende Beispiel veranschaulicht die Verwendung des SetVar-Elements zum Festlegen des globalen Gültigkeitsbereichs für eine Variable. Die zweite Zeile gibt den in der ersten Zeile festgelegten Wert zurück.
<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">
Im folgenden Beispiel gibt das erste GetVar-Element und Value_2 das zweite GetVar-Element zurück Value_1 , da das SetVar-Element , das enthält Value_2 , nur für untergeordnete Elemente des Sample-Elements gilt. Value_2 außerhalb des Gültigkeitsbereichs nach dem schließenden Sample-Tag.
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
Im folgenden Beispiel wird ausgewertet, ob ein Feld erforderlich ist. Falls erforderlich, wird das rote Sternchen (*) erstellt, das neben pflichtlichen Feldern in Formularen Neu oder Bearbeiten angezeigt wird, und legt die HasRequired-Variable auf TRUE fest.
<Switch>
<Expr>
<Property Select="Required"/>
</Expr>
<Case Value="TRUE">
<HTML><![CDATA[<font color=red> *</font>]]></HTML>
<SetVar Scope="Request" Name="HasRequired">TRUE</SetVar>
</Case>
</Switch>