Partilhar via


Elemento FilterLink (Exibição)

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

Retorna a URL para filtrar uma exibição; normalmente usado nas barras de ferramentas que aparecem acima das listas.

<FilterLink
  AutoHyperLink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
  Default = "Text"
..ExpandXML = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  Paged = "TRUE" | "FALSE"
  StripWS = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsURL = "TRUE" | "FALSE">
</FilterLink>

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 quebra (&nbsp;).
Padrão
Texto opcional. Especifica a cadeia de caracteres de filtro a ser usada na geração da HREF (referência de hipertexto) para um link para um item quando a URL não especifica um parâmetro Filter . Se estiver vazio, a URL do link não conterá um parâmetro Filter .
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.
Paginada
Booliano opcional. TRUE se os itens da lista forem exibidos página por 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, para o formato UTF-8 citado (por exemplo, %c3%ab para 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 FilterLink retorna uma cadeia de caracteres de URL como a seguinte:

http://Site_Name/Lists/Events/AllItems.aspx?Filter=1&amp;View=%7b4A760E71%2dEBF2%2d4A88%2d9B2E%2dCFDE10E1825A%7d

Exemplo

O exemplo a seguir usa o elemento FilterLink para construir um hiperlink para o ícone de filtro, de modo que a seleção do ícone posta a URL para aplicar opções de filtro na exibição de lista.

<HTML><![CDATA[ <a tabindex=2 ID=diidFilterButton class="ms-toolbar"
   title=]]></HTML>
<HTML>"Filter"</HTML>
<HTML><![CDATA[ ACCESSKEY=L href="javascript:"
   OnClick='javascript:SubmitFormPost("]]></HTML>
<ScriptQuote NotAddingQuote="TRUE">
   <FilterLink Paged="FALSE"/>
</ScriptQuote>
<HTML><![CDATA[");javascript:return false;'>
   <img src="/_layouts/images/tbfilter.gif" ID="tbbuttonstart1"
   alt=]]></HTML>
<HTML>"Filter"</HTML>
<HTML><![CDATA[ border=0 width=16 height=16></a></HTML>