GetVar-Element (View)
Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Gibt eine Variable im Kontext des Seitenrenderings zurück. Variablen können entweder lokal auf die aktuelle XML-Ebene oder global auf die Seite festgelegt werden.
<GetVar
AutoHyperlink = "TRUE" | "FALSE"
AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
AutoNewLine = "TRUE" | "FALSE"
Default = "TRUE" | "FALSE"
ExpandXML = "TRUE" | "FALSE"
HTMLEncode = "TRUE" | "FALSE"
Name = "Text"
Scope ="Request"
StripWS = "TRUE" | "FALSE"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsURL = "TRUE" | "FALSE">
</GetVar>
Elemente und Attribute
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Attribute
| Attribut | Beschreibung |
|---|---|
|
AutoHyperlink |
Optionaler Boolean-Wert.
TRUE , um Text mit <A> Tags einzuschließen, wenn der Text wie ein Link angezeigt wird, www.microsoft.comz. B. . |
|
AutoHyperLinkNoEncoding |
Optionaler Boolean-Wert.
TRUE , um Text mit <A> Tags einzuschließen, wenn der Text wie ein Link (z. B. ) angezeigt wird, www.microsoft.comaber ohne HTML-Codierung. |
|
AutoNewLine |
Optionaler Boolean-Wert.
TRUE , um Tags in den Textstream einzufügen <BR> und mehrere Leerzeichen durch ein unterbrechungsfreies Leerzeichen ( ) zu ersetzen. |
|
Default |
Optionaler Text. Rendert den diesem Attribut zugewiesenen Text, wenn der vom Select-Attribut eines anderen Elements zurückgegebene Wert eine leere Zeichenfolge ist. |
|
ExpandXML |
Optionaler Boolean-Wert. Ist TRUE, um den gerenderten Inhalt erneut durch den CAML-Interpreter (Collaborative Application Markup Language) zu leiten, damit CAML CAML-Daten rendern kann. |
|
HTMLEncode |
Optionaler Boolean-Wert. Ist TRUE, um eingebettete Zeichen zu konvertieren, sodass sie als Text im Browser angezeigt werden. Mit anderen Worten, Zeichen, die mit HTML-Tags verwechselt werden können, werden in Entitäten konvertiert. |
|
Name |
Erforderlicher Text. Der Name der Variablen. |
|
Scope |
Wenn dieser Wert auf Request festgelegt wird, ist die Variable auf der Seite global verfügbar. |
|
StripWS |
Optionaler Boolean-Wert. Ist TRUE, um Leerzeichen vom Anfang und Ende des vom Element zurückgegebenen Werts zu entfernen. |
|
URLEncode |
Optionaler Boolean-Wert.
TRUE , um Sonderzeichen, z. B. Leerzeichen, in UTF-8-Format in Anführungszeichen zu konvertieren, %c3%ab z. B. für zeichen ë. |
|
URLEncodeAsUrl |
Optionaler Boolean-Wert. Wie URLEncode, aber TRUE , um anzugeben, dass die zu codierende Zeichenfolge eine Pfadkomponente einer URL ist, sodass Schrägstriche (/) nicht codiert werden. |
Untergeordnete Elemente
Keine
Übergeordnete Elemente
Zahlreich
Vorkommen
- Minimum: 0
- Maximum: Unbegrenzt
Hinweise
Das GetVar-Element wird häufig innerhalb eines Expr-Elements in einem Switch- oder IfEqual-Element verwendet.
Wenn Scope="Request" im SetVar-Element angegeben wird, tritt eine Variablenzuweisung an beliebiger Stelle auf der aktuellen Seite in Kraft. Andernfalls betrifft die Zuweisung nur untergeordnete Elemente des SetVar-Elements.
Beispiel
Im folgenden Beispiel werden mithilfe des GetVar-Elements aktuelle Filterinformationen zurückgegeben, um zu bestimmen, welcher Text auf der Symbolleiste oberhalb der Liste angezeigt werden soll.
<Switch>
<Expr>
<GetVar Name="Filter" />
</Expr>
<Case Value="1">
<HTML>Hide Filter Choices</HTML>
</Case>
<Default>
<Switch>
<Expr>
<GetVar Name="FilterField1" />
</Expr>
<Case Value="">
<HTML>Filter</HTML>
</Case>
<Default>
<HTML>Change Filter</HTML>
</Default>
</Switch>
</Default>
</Switch>
Wenn Filteroptionen in der Liste geöffnet sind und die Filtervariable 1 enthält, wird Filterauswahl ausblenden angezeigt. Andernfalls implementiert die Standardaktion eine zweite Switch-Anweisung , die eine zweite Variable auswertet, FilterField1. Wenn der Wert von FilterField1 eine leere Zeichenfolge ist, wird kein Filter angewendet, und Filter wird auf der Symbolleiste angezeigt. Andernfalls wird standardmäßig filter ändern angezeigt.