Microsoft.SharePoint.Linq - Espace de noms

Fournit les classes qui implémentent le fournisseur LINQ to SharePoint.

La classe de passerelle principale qui permet d'accéder à la Microsoft SharePoint Foundation est DataContext qui fournit le pour LINQ interroger, en écriture pour les bases de données de contenu et gestion du changement objet. La méthode la plus importante deux sont GetList<T>(String), qui retourne l'objet queryable EntityList<TEntity> qui représente une liste et SubmitChanges(), qui écrit les modifications apportées à la base de données de contenu.

L'espace de noms fournit également un ensemble de « classes d'entité » qui représentent des éléments de liste et les valeurs de champ et qui, avec EntityList<TEntity> fournissez un mappage relationnel d'objets et de l'interface entre votre code .net orientée objet et la structure relationnelle des bases de données de contenu. Les autres classes d'entité principal sont EntityRef<TEntity>, EntitySet<TEntity>et LookupList<T>. Les deux premiers ces implémentent le chargement différé ; Si le constructeur d'un EntityList<TEntity> n'a pas de chargement des objets d'entité à partir de ses associations entité. Chaque champ dans un élément de liste est chargé que lorsqu'il est tout d'abord référencé dans le code du constructeur après.

Un ensemble complet de classes d'attributs fournis pour faciliter le mappage relationnel d'objets. ContentTypeAttribute, qui décore une classe qui représente le type de contenu de liste, ColumnAttribute, qui décore une propriété qui représente une colonne (champ) dans une liste et AssociationAttribute, qui décore des propriétés qui représentent une relation de liste de choix entre une colonne dans une liste et une colonne dans une autre sont les plus importants de ces.

Fournisseur LINQ to SharePoint permet d'écrire dans les bases de données de contenu à l'aide de l'accès concurrentiel optimiste. Cela nécessite un système de suivi des modifications apportées aux objets, détection des conflits d'accès concurrentiel et résoudre les conflits. Plusieurs classes sont fournis pour prendre en charge de ce système notamment ITrackEntityState, ObjectChangeConflictet MemberChangeConflict.

Enfin, l'interface ICustomMapping fournit un moyen de l'extension d'une solution déjà déployé SharePoint Foundation pour gérer les colonnes ajoutées à une liste après le déploiement initial sans nécessiter recompilation des assemblys de solution d'origine ou même redéploiement d'entre eux.

Notes

L'espace de noms contient également des deux classes de public nécessaires pour activer les listes de SharePoint Foundation interroger avec ADO.NET Data Services. Ils ne sont pas documentés, car ils ne doivent pas être appelées à partir de votre code.

Classes

	Classe	Description
	AssociationAttribute	Spécifie qu'une association à une autre liste, par exemple lorsque la propriété est mappée à un champ liste de choix à la propriété (mappée sur un champ de la liste).
	AssociationChangedEventArgs<T>	Fournit des données pour l'événement OnChanged de EntityRef<TEntity>, EntitySet<TEntity>ou Microsoft.SharePoint.Linq.LookupList<T>.
	ChangeConflictCollection	Représente une collection d'objets ObjectChangeConflict .
	ChangeConflictException	Représente l'exception qui est levée lorsqu'une mise à jour échoue parce que les valeurs de base de données ont été mis à jour depuis leur dernière lecture par le client.
	ChoiceAttribute	Mappe un membre d'une énumération à valeur de choix pour un champ de type choix ou choix dans une liste de Microsoft SharePoint FoundationString .
	ColumnAttribute	Spécifie que la propriété est mappée à un champ (colonne) dans une liste de Microsoft SharePoint Foundation .
	ContentTypeAttribute	Spécifie que la classe est mappée à un type de contenu de Microsoft SharePoint Foundation .
	CustomMappingAttribute	Identifie les nouvelles colonnes sont mis en correspondance avec la méthode MapFrom(Object) qui est décorée avec l'attribut.
	DataAttribute	Fournit deux propriétés facultatives couramment utilisées par des attributs sur les propriétés (des classes d'entité) qui sont mappées à des champs (colonnes) de la liste des propriétés de la liste.
	DataContext	Fournit l'accès LINQ (Language Integrated Query) et pour le suivi des modifications, les listes et les bibliothèques de documents d'un site Web de Microsoft SharePoint Foundation .
	DerivedEntityClassAttribute	Identifie une classe qui dérive de la classe à laquelle l'attribut est appliqué.
	EntityList<TEntity>	Représente une liste de Microsoft SharePoint Foundation qui peut être interrogée avec LINQ Language Integrated Query ().
	EntityRef<TEntity>	Offre différé Maintenance de chargement et relation pour le côté singleton d'une relation un-à-plusieurs.
	EntitySet<TEntity>	Fournit différé Maintenance de chargement et relation pour le côté « plusieurs » de relations un-à-plusieurs et plusieurs-à-plusieurs
	ListAttribute	Spécifie qu'une propriété d'un objet DataContext représente une liste de Microsoft SharePoint Foundation .
	LookupList<T>	Représente les valeurs d'un champ liste de choix Microsoft SharePoint Foundation (colonne) qui permet à plusieurs valeurs.
	MemberChangeConflict	Spécifie des informations sur une différence entre la valeur d'un champ (ou d'une propriété de métadonnées d'élément list) dans la base de données et sa valeur dans le processus en cours sur le serveur Web frontal - sa valeur client.
	ObjectChangeConflict	Spécifie des informations sur les différences entre la valeur actuelle de client d'un ou plusieurs champs dans un élément de liste et les valeurs actuelles de la base de données des champs.
	RemovedColumnAttribute	Spécifie que la propriété est mappée à un champ (colonne) qui se trouve sur le type de contenu parent mais a été supprimé du type de contenu dérivé.
	ResourceStrings	Ce type ou membre prend en charge de Microsoft Windows SharePoint Services et n'est pas destinée à être utilisée directement à partir de votre code.
	Utility	Fournit des fonctionnalités diverses pour le fournisseur LINQ to SharePoint.

Interfaces

	Interface	Description
	ICustomMapping	Permet à une extension du système de mappage objet-relationnel du fournisseur LINQ to SharePoint.
	ITrackEntityState	Permet la participation de l'objet système de LINQ de suivi au fournisseur de SharePoint.
	ITrackOriginalValues	Permet l'implémentation de classes pour stocker un dictionnaire des propriétés modifiées et leurs valeurs d'origine.

Énumérations

	Énumération	Description
	AssociationChangedState	Spécifie comment un EntityRef<TEntity>, EntitySet<TEntity>ou Microsoft.SharePoint.Linq.LookupList<T> change.
	AssociationType	Spécifie le type de relation de recherche entre un champ (colonne) dans une liste et un champ dans une autre liste.
	ConflictMode	Spécifie quand une tentative d'envoyer les modifications à une liste doit être arrêtée et une ChangeConflictException est levée.
	EntityState	Enregistre l'état d'une entité (généralement un élément de liste ; mais éventuellement une entité détachée) modifié.
	RefreshMode	Spécifie la façon dont l'élément de liste modification du système de LINQ pour fournisseur SharePoint répondra lorsqu'elle détecte qu'un élément de liste a été modifié par un autre processus dans la mesure où il a été récupéré.