Elemento ProjectedFields (View)

Última modificación: viernes, 15 de octubre de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

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>

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 primarios

View

Repeticiones

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. No obstante, un elemento ProjectedFields que forma el valor de una propiedad SPQuery.ProjectedFields y, por lo tanto, no es un elemento secundario de un elemento View puede usarse para admitir una combinación implícita sin un elemento Joins. No se recomienda trabajar sin un elemento Joins. Las posibilidades de que la solución sea compatible con versiones futuras de Microsoft SharePoint Foundation se maximizan si se usa siempre un elemento Join explícito. Para obtener más información acerca de las combinaciones implícitas con elementos ProjectedFields, vea Combinaciones de lista y proyecciones.

Mínimo: 0

Máximo: 1

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 (View). 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. Desde SharePoint Foundation 2010, todas las combinaciones deben basarse en una relación de búsqueda existente, de modo que Type siempre tenga el valor "Lookup". El tipo de datos real del campo no se indica cuando es un elemento secundario del elemento ProjectedFields. No obstante, el tipo de datos del campo no tiene importancia, ya que solo los siguientes tipos de campos pueden incluirse en un elemento ProjectedFields:

  • Calculated (se trata como texto sin formato)

  • ContentTypeId

  • Counter

  • Currency

  • DateTime

  • Guid

  • Integer

  • Note (únicamente una línea)

  • Number

  • 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 Combinaciones de lista y proyecciones.