FieldSwitch, élément (View)
Dernière modification : mardi 6 avril 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences
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>
Attributs
Attribut |
Description |
---|---|
StripWS |
Boolean facultatif. TRUE pour supprimer les espaces situés au début et à la fin de la valeur retournée par l'élément. |
Éléments enfants
Éléments parents
Nombreux |
Occurrences
Minimum : 0 Maximum : illimité |
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 si aucune des valeurs Case ne correspond à la valeur Expr, l'élément FieldSwitch retourne une chaîne vide.
Cet élément ne nécessite aucun élément parent donné.
Exemple
L’exemple suivant, extrait du fichier FldTypes.xml, définit deux modèles d’affichage différents pour un champ Note selon que le champ possède 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>