Partager via


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
Classe publique 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).
Classe publique AssociationChangedEventArgs<T> Fournit des données pour l'événement OnChanged de EntityRef<TEntity>, EntitySet<TEntity>ou Microsoft.SharePoint.Linq.LookupList<T>.
Classe publique ChangeConflictCollection Représente une collection d'objets ObjectChangeConflict .
Classe publique 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.
Classe publique 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 .
Classe publique ColumnAttribute Spécifie que la propriété est mappée à un champ (colonne) dans une liste de Microsoft SharePoint Foundation .
Classe publique ContentTypeAttribute Spécifie que la classe est mappée à un type de contenu de Microsoft SharePoint Foundation .
Classe publique CustomMappingAttribute Identifie les nouvelles colonnes sont mis en correspondance avec la méthode MapFrom(Object) qui est décorée avec l'attribut.
Classe publique 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.
Classe publique 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 .
Classe publique DerivedEntityClassAttribute Identifie une classe qui dérive de la classe à laquelle l'attribut est appliqué.
Classe publique EntityList<TEntity> Représente une liste de Microsoft SharePoint Foundation qui peut être interrogée avec LINQ Language Integrated Query ().
Classe publique EntityRef<TEntity> Offre différé Maintenance de chargement et relation pour le côté singleton d'une relation un-à-plusieurs.
Classe publique EntitySet<TEntity> Fournit différé Maintenance de chargement et relation pour le côté « plusieurs » de relations un-à-plusieurs et plusieurs-à-plusieurs
Classe publique ListAttribute Spécifie qu'une propriété d'un objet DataContext représente une liste de Microsoft SharePoint Foundation .
Classe publique LookupList<T> Représente les valeurs d'un champ liste de choix Microsoft SharePoint Foundation (colonne) qui permet à plusieurs valeurs.
Classe publique 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.
Classe publique 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.
Classe publique 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é.
Classe publique 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.
Classe publique Utility Fournit des fonctionnalités diverses pour le fournisseur LINQ to SharePoint.

Interfaces

  Interface Description
Interface publique ICustomMapping Permet à une extension du système de mappage objet-relationnel du fournisseur LINQ to SharePoint.
Interface publique ITrackEntityState Permet la participation de l'objet système de LINQ de suivi au fournisseur de SharePoint.
Interface publique 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
Énumération publique AssociationChangedState Spécifie comment un EntityRef<TEntity>, EntitySet<TEntity>ou Microsoft.SharePoint.Linq.LookupList<T> change.
Énumération publique AssociationType Spécifie le type de relation de recherche entre un champ (colonne) dans une liste et un champ dans une autre liste.
Énumération publique ConflictMode Spécifie quand une tentative d'envoyer les modifications à une liste doit être arrêtée et une ChangeConflictException est levée.
Énumération publique EntityState Enregistre l'état d'une entité (généralement un élément de liste ; mais éventuellement une entité détachée) modifié.
Énumération publique 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é.