Elemento FieldSwitch (Exibição)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Obsoleto. Permite a renderização condicional com base no valor de uma propriedade de campo.

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

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
StripWS	Booliano opcional. TRUE para remover o espaço em branco do início e do final do valor retornado pelo elemento.

Elementos filho

Elementos pai

Numerosos

Occurrences

Mínimo: 0
Máximo: Desvinculado

Comentários

O elemento FieldSwitch e o elemento Switch usam sintaxe idêntica, mas um elemento FieldSwitch é avaliado apenas uma vez por solicitação para cada exibição em que se aplica a um corpo de exibição ou a cada campo em que se aplica a um padrão de exibição. O elemento FieldSwitch otimiza substancialmente o desempenho nos casos em que diferentes caminhos de código caml (linguagem de marcação de aplicativo colaborativo) são necessários, dependendo de uma propriedade de campo (por exemplo, se a formatação de texto avançada está habilitada) cujo valor não é alterado durante o processo de renderização.

Um elemento FieldSwitch contém um elemento Expr , qualquer número de elementos Case e um elemento Default . O valor do elemento Expr é comparado com o atributo Valor de cada elemento Case . Quando uma correspondência é encontrada, o elemento FieldSwitch retorna o valor do elemento Case correspondente. Se nenhuma correspondência for encontrada e se um elemento Default for fornecido, o elemento FieldSwitch retornará o valor do elemento Padrão . Se nenhum elemento Padrão for especificado e nenhum dos valores Case corresponder ao valor Expr , o elemento FieldSwitch retornará uma cadeia de caracteres vazia.

Esse elemento não requer nenhum elemento pai específico.

Exemplo

O exemplo a seguir do arquivo FldTypes.xml define dois padrões de renderização diferentes para um campo Observação , dependendo se o campo tem formatação de texto avançada.

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

Confira também

Elemento Switch (Exibição)

Compartilhar via