FieldSwitch-Element (Ansicht)
Letzte Änderung: Dienstag, 6. April 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
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>
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
Zahlreiche |
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 wurde, gibt das FieldSwitch-Element den Wert des Default-Elements zurück. Wenn kein Default-Element angegeben ist und kein Case-Wert dem Expr-Wert entspricht, 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>