SetVar-Element (Ansicht)
Letzte Änderung: Freitag, 30. Mai 2008
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
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>
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. |
Value |
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 |
Hinweise
Das SetVar-Element hat eine übergreifende und eine nicht übergreifende Form, sodass <SetVar Name="MyVar">Announcements</SetVar> identisch mit <SetVar Name="MyVar" Value="Announcements/> ist.
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 |
|---|---|
DISPLAY |
Wird beim Rendern des Abschnitts ViewBody einer Ansicht verwendet. |
EDIT |
Wird beim Rendern eines Elementbearbeitungsformulars verwendet. |
DISPLAYHEAD |
Wird beim Rendern des Abschnitts ViewHeader einer Ansicht verwendet. |
NEW |
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. |
Beispiel
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 "Value_2" und das zweite GetVar-Element "Value_1" zurück, da das SetVar-Element, das "Value_2" enthält, nur für untergeordnete Elemente des Elements "Sample" gilt. "Value_2" gehört hinter dem schließenden "Sample"-Tag nicht mehr zum Gültigkeitsbereich.
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
Das folgende Beispiel wertet aus, ob ein Feld erforderlich ist. Falls ja, wird das rote Sternchen (*) erstellt, das in den Formularen Neu und Bearbeiten neben den Pflichtfeldern angezeigt wird, und die Variable HasRequired auf TRUE festgelegt.
<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>