FieldSwitch 元素 (视图)

适用于: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

已过时。 允许基于字段属性值进行条件呈现。

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

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
StripWS
可选属性,类型为 Boolean。 如果为 TRUE,则移除元素返回的值开头和末尾的空格。

子元素

父元素

众多

出现次数

  • 最小值:0
  • 最大值:无限制

备注

虽然 FieldSwitch 元素和 Switch 元素使用的语法相同,但对于将它应用于其中的视图正文的每个视图或应用于其中的显示模式的每个字段的每次请求,只计算一次 FieldSwitch 元素。 在需要不同的协作应用程序标记语言 (CAML) 代码路径的情况下,FieldSwitch 元素会充分优化性能,具体取决于其值在呈现过程中不会发生更改的字段属性(例如,是否启用格式文本格式)。

一个 FieldSwitch 元素包含一个 Expr 元素、任意数量的 Case 元素和一个 Default 元素。 将 Expr 元素的值与每个 Case 元素的 Value 属性进行比较。 当找到一个匹配项时,FieldSwitch 元素将返回与 Case 元素相匹配的值。 如果未找到匹配项,并且提供了 Default 元素, 则 FieldSwitch 元素将返回 Default 元素的值。 如果未指定 Default 元素,并且 Case 值均与 Expr 值匹配, 则 FieldSwitch 元素将返回空字符串。

此元素不需要任何特定的父元素。

示例

下面的示例来自 FldTypes.xml 文件,此示例定义 Note 字段的两种不同的呈现模式,具体取决于该字段是否为 RTF 格式。

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

另请参阅