Elemento ProjectedFields (Vista)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Especifica los campos de listas combinadas que pueden incluirse en la vista cuando una o varias listas adicionales se han combinado en una consulta.

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

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Ninguno

Elementos secundarios

• Field

Nota:

Existe un número máximo de elementos secundarios Field. Se define como la diferencia entre el número máximo de campos permitidos en la lista y el número de campos que ya se encuentran en la lista.

Elementos principales

View

Repeticiones

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

Nota:

El elemento View no puede tener un elemento ProjectedFields a menos que tenga un elemento Joins que tenga al menos un elemento secundario Join. Sin embargo, un elemento ProjectedFields que forma el valor de una propiedad SPQuery.ProjectedFields y, por tanto, no es un elemento secundario de un elemento View , se puede usar para admitir una combinación implícita sin un elemento Joins .

No se recomienda trabajar sin un elemento Joins. Maximizará las posibilidades de que la solución sea compatible con futuras versiones de Microsoft SharePoint Foundation mediante el uso siempre de un elemento Join explícito. Para obtener más información acerca de las combinaciones implícitas con elementos ProjectedFields, vea List Joins and Projections.

Comentarios

Si un campo de una lista combinada no se representa en ProjectedFields, no puede incluirse en el elemento ViewFields.

Ejemplo

En el siguiente ejemplo se muestra cómo agregar otro campo a los resultados que devuelve la consulta. El valor del atributo List es un alias de la lista externa. El alias se define en un elemento Join (Vista). El atributo ShowField debe establecerse en el nombre interno del campo externo.

El atributo Type no indica el tipo de datos del campo tal como suele hacerlo en un elemento Field. Cuando un elemento Field es un elemento secundario de un elemento ProjectedFields, Type indica simplemente si el elemento Join (en el elemento Joins del que depende el elemento ProjectedFields) se basa en una relación de búsqueda existente entre las listas. A partir de SharePoint Foundation 2010, todas las combinaciones deben basarse en una relación de búsqueda existente, por lo que Type siempre tiene el valor "Lookup". El tipo de datos real del campo no se indica cuando es un elemento secundario del elemento ProjectedFields. Sin embargo, el tipo de datos del campo es importante porque solo se pueden incluir los siguientes tipos de campos en un elemento ProjectedFields :

• Calculated (se trata como texto sencillo)
• ContentTypeId
• Contador
• Divisa
• DateTime
• Guid
• Entero
• Note (únicamente una línea)
• Número
• Text

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

Para obtener un ejemplo de un elemento ProjectedFields cuyo elemento secundario Field tenga un atributo FieldRef en lugar de un atributo List, vea List Joins and Projections.