FieldSwitch 元素(视图)

上次修改时间: 2015年3月9日

适用范围: SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

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

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

属性

属性

说明

StripWS

可选属性,类型为 Boolean。若要移除由元素返回的值的前后空格,则为 TRUE。

子元素

CaseDefaultExpr

父元素

很多

出现次数

最小值:0

最大值:无限制

备注

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

一个 FieldSwitch 元素包含一个 Expr 元素、任意数量的 Case 元素和一个 Default 元素。将 Expr 元素的值与每个 Case 元素的 Value 属性进行比较。当找到一个匹配项时,FieldSwitch 元素将返回与 Case 元素相匹配的值。如果未找到任何匹配项,并且已给定 Default 元素,则 FieldSwitch 元素将返回 Default 元素的值。如果未指定 Default 元素并且没有与 Expr 值匹配的 Case 值,则 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>

请参阅

引用

Switch 元素(视图)