Espacio de nombres Microsoft.SharePoint.Linq

Proporciona las clases que implementan el proveedor LINQ to SharePoint.

La clase de puerta de enlace principal que proporciona acceso a la Microsoft SharePoint Foundation es DataContext que proporciona Linq consultar, escribir en las bases de datos de contenido y objetos de administración de cambios. Método más importantes su dos son GetList<T>(String), que devuelve el objeto queryable EntityList<TEntity> que representa una lista y SubmitChanges(), que escribe los cambios a la base de datos de contenido.

El espacio de nombres también proporciona un conjunto de "clases de entidad" que representan los elementos de lista y los valores de campo y que, junto con EntityList<TEntity> proporcionar una asignación relacional de objetos y de la interfaz entre el código de .net orientada a objetos y la estructura relacional de las bases de datos de contenido. Las otras clases de entidad de seguridad de la entidad son EntityRef<TEntity>, EntitySet<TEntity>y LookupList<T>. Las dos primeras de estos implementan carga diferida; por lo que no tiene el constructor de un EntityList<TEntity> cargar objetos de entidad de sus asociaciones de entidad. Cada campo de un elemento de lista está cargado solo cuando lo en primer lugar se hace referencia en el código del constructor post.

Para facilitar la asignación relacional de objetos, se proporcionan un amplio conjunto de clases de atributo. Los más importantes de éstos son ContentTypeAttribute, que adorna una clase que representa el tipo de contenido de una lista, ColumnAttribute, que adorna una propiedad que representa una columna (campo) en una lista y AssociationAttribute, que adorna las propiedades que representan una relación de la búsqueda entre una columna en una lista y una columna en otra.

LINQ to SharePoint permite la escritura en las bases de datos de contenido mediante la concurrencia optimista. Esto requiere un sistema de seguimiento de los cambios a objetos, detectar conflictos de concurrencia y resolver los conflictos. Se proporcionan varias clases para admitir este sistema incluidos ITrackEntityState, ObjectChangeConflicty MemberChangeConflict.

Por último, la interfaz de ICustomMapping proporciona un medio de ampliación de una solución ya implementado SharePoint Foundation para controlar las columnas agregadas a una lista después de la implementación inicial sin necesidad de recopilación de los ensamblados de la solución original o incluso redistribución de ellos.

Nota

El espacio de nombres también contiene dos clases de public es necesarias para habilitar las listas de SharePoint Foundation consultas con ADO.NET Data Services. Estos no se encuentran documentados porque no se deben llamar desde el código.

Clases

  Clase Descripción
Clase pública AssociationAttribute Especifica que la propiedad (asignada a un campo de lista) tiene una asociación con otra lista, como cuando la propiedad se asigna a un campo de búsqueda.
Clase pública AssociationChangedEventArgs<T> Proporciona datos para el evento OnChanged de EntityRef<TEntity>, EntitySet<TEntity>o Microsoft.SharePoint.Linq.LookupList<T>.
Clase pública ChangeConflictCollection Representa una colección de objetos ObjectChangeConflict .
Clase pública ChangeConflictException Representa la excepción que se produce cuando se produce un error en una actualización porque los valores de la base de datos se han actualizado desde que el cliente los leyó por última vez.
Clase pública ChoiceAttribute Un miembro de una enumeración se asigna a un valor de la opción String de un campo de tipo opción o varias en una lista de Microsoft SharePoint Foundation .
Clase pública ColumnAttribute Especifica que la propiedad se asigna a un campo (columna) de una lista de Microsoft SharePoint Foundation .
Clase pública ContentTypeAttribute Especifica que la clase se asigna a un tipo de contenido de Microsoft SharePoint Foundation .
Clase pública CustomMappingAttribute Identifica qué nuevas columnas se asignan mediante el método MapFrom(Object) que está decorado con el atributo.
Clase pública DataAttribute Proporciona dos propiedades opcionales utilizadas con frecuencia por los atributos de las propiedades (de las clases de entidad) que se asignan a los campos (columnas) de la lista o propiedades de la lista.
Clase pública DataContext Proporciona acceso LINQ (Language Integrated Query) y control de cambios, las listas y bibliotecas de documentos de un sitio Web de Microsoft SharePoint Foundation .
Clase pública DerivedEntityClassAttribute Identifica una clase que se deriva de la clase a la que se aplica el atributo.
Clase pública EntityList<TEntity> Representa una lista de Microsoft SharePoint Foundation que se puede consultar con Language Integrated Query (LINQ).
Clase pública EntityRef<TEntity> Se proporciona para el mantenimiento de relación y carga aplazada para el lado del singleton de una relación uno a varios.
Clase pública EntitySet<TEntity> Proporciona para mantenimiento diferido de carga y la relación para el lado "varios" de las relaciones de uno a muchos y muchos a muchos
Clase pública ListAttribute Especifica que una propiedad de un objeto DataContext representa una lista de Microsoft SharePoint Foundation .
Clase pública LookupList<T> Representa los valores de un campo de búsqueda de Microsoft SharePoint Foundation (columna) que permite varios valores.
Clase pública MemberChangeConflict Especifica información sobre una discrepancia entre el valor de un campo (o la propiedad de metadatos de elemento de lista) en la base de datos y su valor en el proceso actual en el servidor Web front-end - el valor de su cliente.
Clase pública ObjectChangeConflict Especifica información sobre discrepancias entre el valor actual del cliente de uno o más campos en un elemento de lista y los valores actuales de la base de datos de los campos.
Clase pública RemovedColumnAttribute Especifica que la propiedad se asigna a un campo (columna) que está en el tipo de contenido primario, pero se quitó del tipo de contenido derivado.
Clase pública ResourceStrings Este tipo o miembro es compatible con Microsoft Windows SharePoint Services y no está pensado para utilizarse directamente desde el código.
Clase pública Utility Proporciona la funcionalidad de varios para el proveedor LINQ to SharePoint.

Interfaces

  Interfaz Descripción
Interfaz pública ICustomMapping Permite la extensión del sistema de asignación de objetos relacionales del proveedor LINQ to SharePoint.
Interfaz pública ITrackEntityState Permite la participación en el objeto de sistema de la consulta LINQ de seguimiento al proveedor de SharePoint.
Interfaz pública ITrackOriginalValues Permite la implementación de clases para almacenar en un diccionario de propiedades cambiadas y sus valores originales.

Enumeraciones

  Enumeración Descripción
Enumeración pública AssociationChangedState Especifica cómo cambia un EntityRef<TEntity>, EntitySet<TEntity>o Microsoft.SharePoint.Linq.LookupList<T> .
Enumeración pública AssociationType Especifica el tipo de relación de búsqueda entre un campo (columna) en una lista y un campo de otra lista.
Enumeración pública ConflictMode Especifica cuándo se debe detener un intento de enviar los cambios realizados en una lista y una ChangeConflictException que se produce.
Enumeración pública EntityState Registra el cambio de estado de una entidad (normalmente un elemento de lista; pero posiblemente una entidad separada).
Enumeración pública RefreshMode Especifica cómo responderá el elemento de lista cambio de sistema de la consulta LINQ al proveedor de SharePoint cuando detecta que un elemento de lista se modificó por otro proceso desde que se recuperó.