Elemento ProjectedFields (View)

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

Especifica os campos em listas unidas que podem ser incluídos no modo de exibição quando uma ou mais listas tiverem sido ingressadas em uma consulta.

<ProjectedFields>
  <Field ... />
  <Field ... />
</ProjectedFields>

Elementos e atributos

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

Atributos

Nenhuma

Elementos filho

• Field

Observação

Há um número máximo de elementos filho do campo. Ela é definida como a diferença entre o número máximo de campos permitidos na lista e o número de campos que já estão na lista.

Elementos pai

View

Occurrences

• Mínimo: 0
• Máximo: 1

Observação

O elemento View não pode ter um elemento ProjectedFields , a menos que tenha um elemento Joins que tenha pelo menos um elemento filho Join . No entanto, um elemento ProjectedFields que forma o valor de uma propriedade SPQuery.ProjectedFields e, portanto, não é um filho de um elemento View , pode ser usado para dar suporte a uma junção implícita sem um elemento Joins .

Não recomendamos trabalhar sem um elemento Joins . Você maximizará as chances da solução de ser compatível com versões futuras do Microsoft SharePoint Foundation usando sempre um elemento de Junção explícito. Para obter mais informações sobre junções implícitas com elementos ProjectedFields , consulte List Joins and Projections.

Comentários

Se um campo de uma lista unida não for representado em ProjectedFields, ele não poderá ser incluído no elemento ViewFields .

Exemplo

O exemplo a seguir mostra como adicionar outro campo aos resultados retornados pela consulta. O valor do atributo List é um alias para a lista estrangeira. O alias é definido em um elemento Join (View). O atributo ShowField deve ser definido como o nome interno do campo externo.

O atributo Type não indica o tipo de dados do campo, como normalmente faz em um elemento Field . Quando um elemento Field é filho de um elemento ProjectedFields , Type simplesmente indica se o elemento Join (no elemento Joins do qual o elemento ProjectedFields depende) é baseado em uma relação de pesquisa existente entre as listas. Desde o SharePoint Foundation 2010, todas as junções devem ser baseadas em uma relação de pesquisa existente, portanto, Type sempre tem o valor "Lookup". O tipo de dados real do campo não é indicado quando ele é um filho do elemento ProjectedFields . No entanto, o tipo de dados do campo importa porque somente os seguintes tipos de campos podem ser incluídos em um elemento ProjectedFields :

• Calculado (tratado como texto sem formatação)
• ContentTypeId
• Contador
• Moeda
• DateTime
• Guid
• Inteiro
• Observação (somente uma linha)
• Número
• Texto

<ProjectedFields>
  <Field
    Name='CustomerCity'
    Type='Lookup'
    List='customerCities'
    ShowField='Title' />
</ProjectedFields>

Para obter um exemplo de um elemento ProjectedFields cujo elemento Field filho tem um atributo FieldRef em vez de um atributo List , consulte List Joins and Projections.