Elemento GetVar (Exibição)

Artigo
04/08/2023

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

Retorna uma variável no contexto de renderização da página. As variáveis podem ser definidas localmente para o nível atual de XML ou globalmente para a página.

<GetVar
  AutoHyperlink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
  Default = "TRUE" | "FALSE"
  ExpandXML = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  Name = "Text"
  Scope ="Request"
    StripWS = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsURL = "TRUE" | "FALSE">
</GetVar>

Elementos e atributos

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

Atributos

Atributo	Descrição
AutoHyperlink	Booliano opcional. TRUE para cercar texto com `<A>` marcas se o texto aparecer como um hiperlink, por exemplo, `www.microsoft.com`.
AutoHyperLinkNoEncoding	Booliano opcional. TRUE para cercar texto com `<A>` marcas se o texto aparecer como um hiperlink (por exemplo, `www.microsoft.com`) mas sem codificação HTML.
AutoNewLine	Booliano opcional. TRUE para inserir `<BR>` marcas no fluxo de texto e substituir vários espaços por um espaço sem interrupções (` `).
Padrão	Texto opcional. Renderiza o texto atribuído a esse atributo se o valor retornado pelo atributo Selecionar de outro elemento for uma cadeia de caracteres vazia.
ExpandXML	Booliano opcional. TRUE para re-passar o conteúdo renderizado por meio do interpretador caml (linguagem de marcação de aplicativo colaborativo), que permite que o CAML renderize CAML.
Htmlencode	Booliano opcional. TRUE para converter caracteres inseridos para que eles sejam exibidos como texto no navegador. Em outras palavras, caracteres que podem ser confundidos com marcas HTML são convertidos em entidades.
Nome	Texto obrigatório. O nome da variável.
Escopo	Se definida como Solicitação, a variável estará disponível globalmente na página.
StripWS	Booliano opcional. TRUE para remover o espaço em branco do início e do final do valor retornado pelo elemento.
Urlencode	Booliano opcional. TRUE para converter caracteres especiais, como espaços, no formato UTF-8 citado, por exemplo, `%c3%ab` para o caractere `ë`.
URLEncodeAsUrl	Booliano opcional. Como URLEncode, mas TRUE para especificar que a cadeia de caracteres a ser codificada é um componente de caminho de uma URL para que as barras de encaminhamento (`/`) não sejam codificadas.

Elementos filho

Nenhum

Elementos pai

Numerosos

Occurrences

Mínimo: 0
Máximo: Desvinculado

Comentários

O elemento GetVar geralmente é usado dentro de um elemento Expr em um elemento Switch ou IfEqual .

Se Scope="Request" for especificado no elemento SetVar , uma atribuição de variável entrará em vigor em qualquer lugar na página atual. Caso contrário, a atribuição afeta apenas os filhos do elemento SetVar .

Exemplo

O exemplo a seguir usa o elemento GetVar para retornar informações de filtragem atuais para determinar qual texto exibir na barra de ferramentas acima da lista.

<Switch>
   <Expr>
      <GetVar Name="Filter" />
   </Expr>
   <Case Value="1">
      <HTML>Hide Filter Choices</HTML>
   </Case>
   <Default>
      <Switch>
         <Expr>
            <GetVar Name="FilterField1" />
         </Expr>
         <Case Value="">
            <HTML>Filter</HTML>
         </Case>
         <Default>
            <HTML>Change Filter</HTML>
         </Default>
      </Switch>
   </Default>
</Switch>

Se as opções de filtro estiverem abertas na lista e a variável Filter contiver 1, ocultar opções de filtro será exibida. Caso contrário, a ação padrão implementará uma segunda instrução do Switch que avalia uma segunda variável, FilterField1. Se o valor de FilterField1 for uma cadeia de caracteres vazia, nenhum filtro será aplicado e Filter será exibido na barra de ferramentas; caso contrário, a ação padrão é exibir o Filtro de Alterações.

Confira também

Elemento SetVar (Exibição)

Compartilhar via