FieldSwitch, élément (View)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Obsolète. Permet l'affichage conditionnel en fonction de la valeur d'une propriété de champ.

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

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
StripWS	Facultatif Boolean. TRUE pour supprimer des espaces au début et à la fin de la valeur renvoyée par l'élément.

Éléments enfants

Éléments parents

Nombreux

Occurrences

Minimum : 0
Maximum : pas de limite

Remarques

Les éléments FieldSwitch et Switch utilisent une syntaxe identique, mais un élément FieldSwitch n'est évalué qu'une fois par demande pour chaque vue dans laquelle il s'applique à un corps d'affichage ou pour chaque champ dans lequel il s'applique à un modèle d'affichage. L'élément FieldSwitch optimise sensiblement les performances lorsque plusieurs chemins de code CAML (Collaborative Application Markup Language) sont nécessaires, selon une propriété de champ (par exemple, si la mise en forme de texte enrichi est activée) dont la valeur ne change pas pendant le processus d'affichage.

Un élément FieldSwitch contient un élément Expr, un nombre quelconque d'éléments Case et un élément Default. La valeur de l'élément Expr est comparée à l'attribut Value de chaque élément Case. Si une correspondance est trouvée, l'élément FieldSwitch retourne la valeur de l'élément Case correspondant. Si aucune correspondance n’est trouvée et si un élément Default est fourni, l’élément FieldSwitch retourne la valeur de l’élément Default . Si aucun élément Default n’est spécifié et qu’aucune des valeurs Case ne correspond à la valeur Expr , l’élément FieldSwitch renvoie une chaîne vide.

Cet élément ne nécessite aucun élément parent donné.

Exemple

L’exemple suivant du fichier FldTypes.xml définit deux modèles de rendu différents pour un champ Note , selon que le champ a ou non une mise en forme de texte enrichi.

<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>

Voir aussi

Élément Switch (View)