Elemento Exibir (Lista)

Artigo
04/08/2023

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

Em uma definição de lista (Schema.xml), define uma exibição para uma lista em um site com base no Microsoft SharePoint Foundation, onde cada lista pode conter uma série de exibições.

Observação

O SharePoint Foundation 2010 usa XSLT para definir exibições de lista e o esquema View é mantido para compatibilidade com versões anteriores. Para obter informações sobre exibições de lista XSLT, consulte Exibições de lista.

<View
  AggregateView = "TRUE" | "FALSE"
  BaseViewID = "Integer"
  ContentTypeID = "Text"  CssStyleSheet = "Text"
  DefaultView = "TRUE" | "FALSE"
  DefaultViewForContentType = "TRUE" | "FALSE"
  DisplayName = "Text"
  FailIfEmpty = "TRUE" | "FALSE"
  FileDialog = "TRUE" | "FALSE"
  FPModified = "TRUE" | "FALSE"
  FreeForm = "TRUE" | "FALSE"
  Hidden = "TRUE" | "FALSE"
  ImageUrl = "Text"
  IncludeRootFolder = "TRUE" | "FALSE"
  List = "Integer" | "Text"
  MobileDefaultView = "TRUE" | "FALSE"  MobileItemLimit = "Integer"  MobileUrl = "Text"
  MobileView = "TRUE" | "FALSE"
  ModerationType = "Text"
  Name = "Text"
  OrderedView = "TRUE" | "FALSE"
  PageType = "Text"
  Path = "Text"
  ReadOnly = "TRUE" | "FALSE"
  RecurrenceRowset = "TRUE" | "FALSE"
  ReqAuth = "TRUE" | "FALSE"
  RequiresClientIntegration = "TRUE" | "FALSE"
  RowLimit = "Integer"
  Scope = "Text"
  SetupPath = "Text"
  ShowHeaderUI = "TRUE" | "FALSE"  TabularView = "TRUE" | "FALSE"
  TargetId = "Text"
  TargetType = "List" | "ContentType"
  Threaded = "TRUE" | "FALSE"
  ToolbarTemplate = "Text"
  Type = "HTML" | "Chart" | "Pivot"
  Url = "Text"
  WebPartOrder = "Integer"
  WebPartZoneID = "Text">
</View>

Elementos e atributos

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

Atributos

Atributo	Descrição
AggregateView	Booliano opcional. TRUE para especificar que a exibição é uma exibição do Merge Forms usada em uma biblioteca de formulários XML. Por padrão, uma biblioteca de FormulárioS XML tem uma exibição do Merge Forms inicialmente oculta. Quando um editor XML é usado para publicar um arquivo XFP (Propriedades de Formulário XML) no diretório Forms da biblioteca, juntamente com um modelo usado pelo editor, o atributo AggregateView identifica a exibição Merge Forms. Essa exibição pode ficar visível ou oculta, dependendo se o modelo de lista ou a definição da biblioteca dão suporte à fusão de dados.
BaseViewID	Inteiro opcional. Especifica a ID do modo de exibição base.
Contenttypeid	Texto opcional. Especifica a ID do tipo de conteúdo com o qual a exibição está associada.
CssStyleSheet	Texto opcional.
DefaultView	Booliano opcional. TRUE para especificar que a exibição é a exibição padrão.
DefaultViewForContentType	Booliano opcional. TRUE para especificar que a exibição é a exibição padrão de um tipo de conteúdo.
DisplayName	Texto opcional. Especifica o nome da exibição exibida na barra de Inicialização Rápida .
FailIfEmpty	Booliano opcional. Se o modo de exibição não retornar itens, TRUE retornará uma página em branco e um código de erro HTTP em vez de renderizar o elemento ViewEmpty . Usado para manipulação programática de exibições de um aplicativo cliente, para que o aplicativo cliente não precise analisar um documento para descobrir se a exibição está vazia.
FileDialog	Booliano opcional. TRUE para especificar que o modo de exibição é exibido em caixas de diálogo de arquivo para aplicativos que são usados no contexto do SharePoint Foundation e que analisam o HTML de saída para determinar o conteúdo da lista.
FPModified	Booliano opcional. TRUE se o modo de exibição tiver sido alterado por meio da edição em um editor de página da Web e o modo de exibição não for mais personalizável pela interface do usuário (interface do usuário) do SharePoint Foundation.
Freeform	Booliano opcional. TRUE para especificar a formatação de campo alternativo para determinados tipos de campo quando os campos são renderizados. Em particular, esse atributo afeta o alinhamento de colunas numéricas, que é particularmente útil em tipos de exibição nontabular personalizados.
Oculto	Booliano opcional. TRUE para ocultar a exibição.
Imageurl	Texto opcional. Especifica a URL relativa ao servidor para a imagem exibida na área de título da exibição de lista, por exemplo, `/_layouts/images/pgrpicon.png`.
IncludeRootFolder	Booliano opcional. TRUE para especificar que a pasta raiz é retornada no modo de exibição de lista.
List	Inteiro opcional ou Texto. Especifica o tipo de lista. Esse valor pode ser a ID do modelo para uma lista (um inteiro) ou a URL para uma lista provisionada no site (uma cadeia de caracteres). A melhor prática é usar Texto, pois o Integer pode não ser específico o suficiente (por exemplo, se houver duas listas de anúncios no site e você especificar List=104).
MobileDefaultView	Booliano opcional. TRUE para especificar que a exibição de lista padrão do SharePoint é a exibição móvel padrão. Somente uma exibição por lista pode ser designada como a exibição móvel padrão.
MobileItemLimit	Inteiro opcional.
MobileUrl	Texto opcional.
Mobileview	Booliano opcional. TRUE para especificar que a exibição de lista padrão do SharePoint também é uma exibição móvel. Esse atributo não se aplica às exibições Calendário, Folha de Dados ou Gantt.
ModeraçãoType	Texto opcional. Especifica o tipo de Aprovação de Conteúdo, que pode ser HideUnapproved, Colaborador ou Moderador. A exibição HideUnapproved oculta itens de rascunho não aprovados de usuários que só têm permissão para ler itens. A exibição Colaborador mostra os itens pendentes e rejeitados para o usuário atual. A exibição Moderador é acessível apenas para usuários que têm permissões de lista gerenciadas e mostra os itens pendentes e rejeitados para todos os usuários.
Nome	Texto opcional. O nome dado ao modo de exibição; usado para selecionar uma exibição nomeada diferente na interface do usuário, bem como para se referir a uma exibição nomeada ao especificar um filtro para um campo Pesquisa .
OrderedView	Booliano opcional. TRUE para especificar se o modo de exibição é ordenado.
PageType	Texto opcional. Especifica o tipo de formulário no qual o modo de exibição é usado. Os valores possíveis incluem o seguinte: DEFAULTVIEW Exibição padrão. DIALOGVIEW Exibição da caixa de diálogo do arquivo. DISPLAYFORM Formulário de exibição para itens de lista. DISPLAYFORMDIALOG Exibir formulário para uma caixa de diálogo de arquivo. EDITFORM Edite o formulário para itens de lista. EDITFORMDIALOG Edite o formulário para uma caixa de diálogo de arquivo. INVÁLIDO Não usado. MAXITEMS Não usado. NEWFORM Novo formulário para itens de lista. NEWFORMDIALOG Novo formulário para uma caixa de diálogo de arquivo. NORMALVIEW Exibição normal. SOLUTIONFORM Formulário de solução. VER Exibição, incluindo exibição padrão e exibição normal.
Path	Texto opcional. Especifica o nome do arquivo para a exibição.
ReadOnly	Booliano opcional. TRUE para tornar a exibição somente leitura.
RecurrenceRowset	Booliano opcional. TRUE para expandir eventos recorrentes no modo de exibição e exibir cada instância de cada evento recorrente. O valor padrão é FALSE.
ReqAuth	Booliano opcional.
RequiresClientIntegration	Booliano opcional. TRUE para usar recursos que iniciam aplicativos cliente; caso contrário, os usuários devem trabalhar em documentos localmente e carregar alterações.
RowLimit	Inteiro opcional. Aplica-se apenas ao tipo de exibição HTML. Especifica o número máximo de linhas a serem renderizadas em qualquer página. Quando o limite de linha é excedido, os botões Avançar e Anterior permitem que todos os conjuntos de registros retornados sejam exibidos. Se RowLimit não for especificado, o número padrão de Linhas retornadas será 50. Se Nenhum for especificado para o tipo de exibição, todas as linhas do conjunto de registros serão retornadas em uma exibição. Quando uma exibição é renderizada, as variáveis de renderização e `ViewHasPrev` são definidas `ViewHasNext` como TRUE ou FALSE, com base em se a exibição atual atingiu o limite de linha do conjunto de dados. Essas variáveis podem ser usadas em definições de página sucessivas para renderizar botões Next e Previous na página, como no exemplo a seguir: `XML<Switch> <Expr><GetVar Name="ViewHasPrev"/></Expr> <Case Value="TRUE"> <![CDATA[...Previous button defined here... ]]> </Case></Switch>` As variáveis `NextPageURL` e `PrevPageURL` também são definidas como valores não íntegros quando há conteúdo de paginação para frente ou para trás da exibição atual. Essas variáveis podem ser usadas construindo os botões Avançar e Anterior para que elas tenham a URL correta para acessar a próxima página de conteúdo.
Escopo	Texto opcional. Especifica o escopo recursivo para uma exibição de uma biblioteca de documentos. Os valores possíveis incluem o seguinte: FilesOnly — mostrar apenas os arquivos de uma pasta específica. Recursivo— Mostrar todos os arquivos de todas as pastas. RecursiveAll— Mostrar todos os arquivos e todas as subpastas de todas as pastas. Se esse atributo não estiver definido, o modo de exibição exibirá apenas os arquivos e subpastas de uma pasta específica. O valor desse atributo corresponde à propriedade Scope da classe SPView .
SetupPath	Texto opcional. Especifica o caminho relativo do site para a pasta no diretório de configuração que contém a página .aspx para a exibição, por exemplo, `pages\viewpage.aspx`.
ShowHeaderUI	Booliano opcional. FALSE para renderizar todos os elementos FieldRef usados no modo de exibição de cabeçalho sem decorar a interface do usuário com HTML. Em outras palavras, quando esse modo é definido, a interface do usuário não fornece classificação e filtragem como hiperlinks no cabeçalho da coluna. O valor padrão é TRUE.
TabularView	Booliano opcional.
Targetid	Texto opcional.
TargetType	Texto opcional. Os valores possíveis incluem List e ContentType.
Threaded	Booliano opcional. TRUE para aplicar o agrupamento interno na exibição. Uma exibição threaded é construída com base na coluna de threading interna (supõe-se que exista para a lista). A exibição é classificada neste campo como a classificação secundária. Se outras colunas no modo de exibição forem especificadas como classificadas ou agrupadas, essas regras serão aplicadas antes da ordem de classificação da coluna de threading. Como resultado, todas as discussões agrupadas por um tópico podem ser coletadas em conjunto e o threading de mensagem pode ser exibido sob a coleção. Quando TRUE, o elemento RowLimit tem um significado diferente quando usado em uma exibição de lista de painel de discussão threaded. Em vez de especificar o número de itens a serem retornados, ele especifica o número de threads de discussão a serem retornados, em que um thread pode consistir em um ou mais itens. Além de ter o atributo Threaded definido como TRUE, um modo de exibição threaded deve ser classificado pela ID do thread; caso contrário, esse comportamento de limite de linha não faz efeito.
Barra de ferramentasTemplate	Texto opcional. Especifica o nome do modelo de barra de ferramentas predefinido que é usado para a barra de ferramentas de exibição.
Tipo	Texto opcional. Especifica o tipo de renderização do modo de exibição. O tipo é a exibição HTML enumerada comum e pode ser definido como HTML, Gráfico ou Pivot.
Url	Texto opcional. Especifica a URL do modo de exibição.
WebPartOrder	Inteiro opcional. Especifica o posicionamento vertical da Web Part dentro de uma zona.
WebPartZoneID	Texto opcional. Especifica a zona para a Web Part.

Elementos filho

Elementos pai

Modos de exibição

Occurrences

Mínimo: 0
Máximo: Desvinculado

Comentários

O tipo de exibição principal para informações de resumo de lista e documento é a exibição HTML. Uma exibição HTML geralmente é uma exibição columnar que exibe informações de uma ou mais listas. Os dados a serem exibidos são descritos pelos campos mostrados na exibição. Para obter informações sobre como as exibições funcionam em Microsoft SharePoint Foundation 2010, consulte Exibições de lista.

Os atributos primários que definem uma exibição HTML são os seguintes:

Seu nome.
A especificação da fonte de dados (geralmente uma única lista ou biblioteca de documentos).
O filtro a ser aplicado à fonte de dados.
A coleção de campos a serem exibidos.
A ordem de classificação dos itens a serem exibidos. Um caso especial de ordem de classificação é agrupamento.
Um modelo HTML para renderizar a exibição.

O elemento Exibir é central para a renderização de página e gera uma consulta SQL para os campos, classificações e filtros que são aplicados em uma exibição específica. O elemento View itera por meio do conjunto de dados retornado pela consulta e executa o elemento ViewBody para cada linha retornada. Dentro do elemento ViewBody , uma enumeração de elemento Fields pode ser usada para manipular cada campo ou cada campo pode ser chamado individualmente pelo nome dentro de um elemento Field .

Cada exibição tem um nome interno que normalmente é representado por um GUID. O modo de exibição pode ser renderizado em uma página usando a exibição </> marca.

Exemplos

O exemplo a seguir ilustra o uso de uma enumeração de campos dentro de um corpo de exibição, estabelecendo uma tabela básica para exibir uma lista no navegador.

<View Name="MyCustomView">
    <ViewHeader>
      <HTML><![CDATA[<TABLE><TR>]]></HTML>
      <Fields>
        <HTML><![CDATA[<TH>]]></HTML>
        <Field/>
        <HTML><![CDATA[</TH>]]></HTML>
      </Fields>
      <HTML><![CDATA[</TR>]]></HTML>
    </ViewHeader>
    <ViewBody>
      <HTML><![CDATA[<TR>]]></HTML>
        <Fields>
          <HTML><![CDATA[<TD>]]></HTML>
          <Field/>
          <HTML><![CDATA[</TD>]]></HTML>
        </Fields>
      <HTML><![CDATA[</TR>]]></HTML>
    </ViewBody>
    <ViewFooter>
      <HTML><![CDATA[</TABLE>]]></HTML>
    </ViewFooter>

Observe que, na seção anterior, a enumeração de campos é usada em uma seção ViewHeader para criar cabeçalhos de coluna para o modo de exibição.

Na seção a seguir do exemplo, uma seção ViewFields é incluída no elemento View para especificar quais campos serão enumerados no modo de exibição.

    <ViewFields>
      <FieldRef Name="Created_x0020_By"/>
      <FieldRef Name="Last_x0020_Modified"/>
    </ViewFields>

Observação

Se o modo de exibição tiver um elemento Joins , os campos das listas ingressadas poderão ser incluídos em ViewFields, desde que também sejam itemizados em um elemento ProjectedFields .

Na última seção do exemplo, o elemento Consulta é usado para especificar um conjunto de resultados que atenda a determinados critérios, como no exemplo a seguir, que retorna uma lista de todos os documentos em uma biblioteca escrita por Mary ou John.

    <Query>
      <Where>
        <Or>
          <Eq>
            <FieldRef Name="Created_x0020_By"/>
            <Value Type="Text">
              Mary
            </Value>
          </Eq>
          <Eq>
            <FieldRef Name="Created_x0020_By"/>
            <Value Type="Text">
              John
            </Value>
          </Eq>
        </Or>
      </Where>
      <OrderBy>
        <FieldRef Name="Last_x0020_Modified"/>
      </OrderBy>
    </Query>
</View>

O próximo exemplo de exibição exibe uma sequência de parágrafos. O elemento Consulta especifica não apenas uma ordem de classificação (em ordem de data de modificação), mas também um filtro (apenas mostrar itens cuja propriedade Expires é maior ou igual à data de hoje).

<View Type="HTML" Name="Summary">
  <ViewBody ExpandXML="TRUE">
    <![CDATA[ <p><SPAN class=DocTitle><ows:Field Name="Title"/></SPAN>
      (<ows:Field Name="Author"/>, <ows:Field Name="Modified"/>)
      <ows:Limit><Field Name="Body"/></ows:Limit>
      </p>  ]]>
  </ViewBody>
  <Query>
    <Where>
      <Geq>
        <FieldRef Name="Expires"/>
        <Value Type="DateTime">
          <Today/>
        </Value>
      </Geq>
    </Where>
    <OrderBy>
      <FieldRef Name="Modified"/>
    </OrderBy>
  </Query>
  <ViewFields>
    <FieldRef Name="Summary"/>
    <FieldRef Name="Author"/>
    <FieldRef Name="Modified"/>
    <FieldRef Name="Body"/>
  </ViewFields>
</View>

Confira também

Exibições de lista

Compartilhar via