FieldSwitch-Element (View)

Artikel
04/08/2023

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Veraltet. Ermöglicht das bedingte Rendern auf der Basis des Werts einer Feldeigenschaft.

<FieldSwitch
   StripWS = "TRUE" | "FALSE">
       <Expr></Expr>
       <Case Value="Value_1"></Case>
       <Case Value="Value_2"></Case>
       ...
       <Default></Default>
</FieldSwitch>

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
StripWS	Optionaler Boolean-Wert. Ist TRUE, um Leerzeichen vom Anfang und Ende des vom Element zurückgegebenen Werts zu entfernen.

Untergeordnete Elemente

Übergeordnete Elemente

Zahlreich

Vorkommen

Minimum: 0
Maximum: Unbegrenzt

Hinweise

Das FieldSwitch-Element und das Switch-Element verwenden eine identische Syntax, aber ein FieldSwitch-Element wird nur einmal pro Anforderung für jede Ansicht ausgewertet, in der es sich auf einen Ansichtskörper bezieht, oder für jedes Feld, in dem es sich auf ein Anzeigemuster bezieht. Das FieldSwitch-Element trägt zu einer wesentlichen Optimierung der Leistung in solchen Fällen bei, in denen verschiedene CAML-Codepfade (Collaborative Application Markup Language) in Abhängigkeit von einer Feldeigenschaft (beispielsweise, ob Rich-Text-Formatierung aktiviert ist) erforderlich sind, deren Wert sich während des Renderns nicht ändert.

Ein FieldSwitch-Element enthält ein Expr-Element, eine beliebige Anzahl von Case-Elementen und ein Default-Element. Der Wert des Expr-Elements wird mit dem Value-Attribut jedes Case-Elements verglichen. Wird eine Übereinstimmung gefunden, gibt das FieldSwitch-Element den Wert des übereinstimmenden Case-Elements zurück. Wenn keine Übereinstimmung gefunden wird und ein Default-Element angegeben wird, gibt das FieldSwitch-Element den Wert des Default-Elements zurück. Wenn kein Default-Element angegeben ist und keiner der Case-Werte mit dem Expr-Wert übereinstimmt, gibt das FieldSwitch-Element eine leere Zeichenfolge zurück.

Für dieses Element ist kein bestimmtes übergeordnetes Element erforderlich.

Beispiel

Das folgende Beispiel aus der Datei FldTypes.xml definiert zwei verschiedene Rendermuster für ein Note-Feld, je nachdem, ob das Feld Rich-Text-Formatierung aufweist oder nicht.

<RenderPattern Name="DisplayPattern" DisplayName="DisplayPattern">
   <FieldSwitch>
      <Expr>
         <Property Select="RichText" />
      </Expr>
      <Case Value="TRUE">
         <Column AutoHyperLinkNoEncoding="TRUE" />
      </Case>
      <Default>
         <Column HTMLEncode="TRUE" AutoHyperLink="TRUE"
            AutoNewLine="TRUE" />
      </Default>
   </FieldSwitch>
</RenderPattern>

Siehe auch

Switch-Element (Ansicht)

Freigeben über