GetVar-Element (View)

Artikel
09/24/2014

Letzte Änderung: Freitag, 30. Mai 2008

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

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>

Attribute

Attribut	Beschreibung
AutoHyperlink	Optionaler Boolean-Wert. TRUE, um Text in <A>-Tags zu setzen, wenn es sich um einen Link handeln könnte, z. B. www.microsoft.com.
AutoHyperLinkNoEncoding	Optionaler Boolean-Wert. TRUE, um Text in <A>-Tags zu setzen, wenn es sich um einen Link handeln könnte (z. B. www.microsoft.com), aber ohne HTML-Codierung.
AutoNewLine	Optionaler Boolean-Wert. TRUE, um <BR>-Tags in den Textstream einzufügen und mehrere Leerzeichen durch ein geschütztes Leerzeichen ( ) zu ersetzen.
Default	Optionaler Text-Wert. Rendert den diesem Attribut zugewiesenen Text, wenn vom Select-Attribut eines anderen Elements eine leere Zeichenfolge als Wert zurückgegeben wurde.
ExpandXML	Optionaler Boolean-Wert. TRUE, um den gerenderten Inhalt erneut den CAML-Interpreter (Collaborative Application Markup Language) durchlaufen zulassen, damit CAML als CAML rendern kann.
HTMLEncode	Optionaler Boolean-Wert. TRUE, um eingebettete Zeichen zu konvertieren, damit sie im Browser als Text dargestellt werden. In anderen Worten werden Zeichen, die mit HTML-Tags verwechselt werden könnten, 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. TRUE, um Leerzeichen am Anfang und Ende des Werts zu entfernen, der vom Element zurückgegeben wird.
URLEncode	Optionaler Boolean-Wert. TRUE, um Sonderzeichen wie Leerzeichen in das UTF-8-Format mit Anführungszeichen zu konvertierten, z. B. "%c3%ab" für das Zeichen "ë".
URLEncodeAsUrl	Optionaler Boolean-Wert. Wie URLEncode, aber TRUE, um anzugeben, dass es sich bei der zu codierenden Zeichenfolge um eine Pfadkomponente einer URL handelt, damit Schrägstriche ("/") nicht codiert werden.

Untergeordnete Elemente

Keines

Übergeordnete Elemente

Zahlreiche

Vorkommen

Mindestvorkommen: 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. Anderenfalls 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 die Filteroptionen in der Liste geöffnet sind und die Filtervariable 1 enthält, wird "Filterauswahl ausblenden" angezeigt. Anderenfalls wird standardmäßig eine zweite Switch-Anweisung implementiert, die eine zweite Variable (FilterField1) auswertet. Wenn der Wert von FilterField1 eine leere Zeichenfolge ist, wird kein Filter angewendet und "Filter" auf der Symbolleiste angezeigt. Anderenfalls wird standardmäßig der Text "Filter ändern" angezeigt.

Siehe auch

Referenz

SetVar-Element (Ansicht)

Freigeben über