Elemento SetVar (Exibição)
Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013
Permite que variáveis sejam definidas no contexto de renderização da página , localmente para o nível atual de XML ou globalmente para a página.
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
Elementos e atributos
As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.
Atributos
| Atributo | Descrição |
|---|---|
| ID |
Texto opcional. Fornece uma ID para a variável. |
| Nome |
Texto obrigatório. Especifica um nome para a variável. |
| Escopo |
Se definida como Solicitação, a variável será global. |
| Valor |
Texto opcional. Pode ser usado para atribuir um valor à variável quando este é um elemento vazio. |
Elementos filho
Nenhum
Elementos pai
Numerosos
Occurrences
- Mínimo: 0
- Máximo: Desvinculado
Comentários
O elemento SetVar tem uma abrangência e um formulário não de abrangência, de modo que seria o mesmo <SetVar Name="MyVar" Value="Announcements/>que <SetVar Name="MyVar">Announcements</SetVar> .
Se Scope="Request" for especificado no elemento SetVar , uma atribuição de variável entrará em vigor em qualquer lugar da página atual. Caso contrário, a atribuição afeta apenas os filhos do elemento SetVar .
O elemento SetVar geralmente é filho de um elemento Method usado no processamento em lote de solicitações.
O elemento SetVar é usado com frequência para alterar o modo de exibição definindo DisplayMode como um dos valores a seguir.
| Valor | Descrição |
|---|---|
| EXIBIR |
Usado ao renderizar a seção ViewBody de uma exibição. |
| EDITAR |
Usado ao renderizar um formulário de item de edição. |
| DISPLAYHEAD |
Usado ao renderizar a seção ViewHeader de uma exibição. |
| Novo |
Usado ao renderizar um novo formulário de item. |
| PREVIEWDISPLAY |
Usado ao editar um formulário de exibição com o Microsoft FrontPage. |
| PREVIEWNEW |
Usado ao editar um novo formulário de item com o FrontPage. |
| PREVIEWEDIT |
Usado ao editar um formulário de item de edição com o FrontPage. |
Exemplos
O exemplo a seguir ilustra o uso do elemento SetVar para definir o escopo global de uma variável. A segunda linha retorna o valor definido na primeira linha.
<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">
No exemplo a seguir, o primeiro elemento GetVar retorna Value_2 e o segundo elemento GetVar retorna Value_1 porque o elemento SetVar que contém Value_2 se aplica apenas a crianças do elemento Sample . Value_2 sai do escopo após a marca de exemplo de fechamento.
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
O exemplo a seguir avalia se um campo é necessário e, se for necessário, cria o asterisco vermelho (*) exibido ao lado dos campos necessários em formulários Novos ou Editar e define a variável HasRequired como TRUE.
<Switch>
<Expr>
<Property Select="Required"/>
</Expr>
<Case Value="TRUE">
<HTML><![CDATA[<font color=red> *</font>]]></HTML>
<SetVar Scope="Request" Name="HasRequired">TRUE</SetVar>
</Case>
</Switch>