Пространство имен Microsoft.SharePoint.Linq

Содержит классы, реализующие поставщик LINQ для SharePoint.

Основной шлюз класс, предоставляющий доступ к Microsoft SharePoint Foundation — DataContext предусматривающей LINQ запрос, записи в базы данных контента и управления изменениями объектов. Его два метода наиболее важными являются GetList<T>(String), которое возвращает объект queryable EntityList<TEntity> , представляющий список и SubmitChanges(), который записывает изменения в базу данных контента.

Пространство имен также предоставляет набор «классов сущностей», представляющие элементов списка и значения полей и которые, наряду с EntityList<TEntity> предоставляют объектно реляционного сопоставления и взаимодействия между объектно ориентированный код .net и реляционной структуры копий баз данных контента. Другие классы основной структуры, EntityRef<TEntity>, EntitySet<TEntity>и LookupList<T>. Первые два из них Реализация отложенной загрузки. Таким образом конструктор EntityList<TEntity> не нужно загружать объекты сущности из его объединения сущности. В каждом поле в элементе списка загружается только тогда, когда он сначала ссылки в коде после конструкторе.

Чтобы облегчить объектно реляционного сопоставления, предоставляются богатый набор классов атрибутов. Наиболее важными из них являются ContentTypeAttribute, который оформляет класс, представляющий тип содержимого списка, ColumnAttribute, который оформляет свойства, представляющего столбец (поле) в списке и AssociationAttribute, который оформляет свойства, представляющие отношения подстановки между в одном списке и столбца в другой.

LINQ to SharePoint позволяет запись в базы данных контента с помощью оптимистичный параллелизм. Для этого системы для отслеживания изменений объектов, обнаружение конфликтов параллельного доступа и разрешения этих конфликтов. Несколько классов предоставляются для поддержки этой системы, включая ITrackEntityState, ObjectChangeConflictи MemberChangeConflict.

Наконец интерфейс ICustomMapping предоставляет средства расширение уже развернутых SharePoint Foundation решения для обработки столбцы, добавленные в список после первоначального развертывания без необходимости повторной компиляции исходного решения сборок или даже перераспределения из них.

Примечание

Пространство имен также содержит два класса public , необходимые для включения запросов SharePoint Foundation списков с помощью служб данных ADO.NET. Они не описаны, поскольку они не должен вызываться из кода.

Классы

  Класс Описание
Общий класс AssociationAttribute Указывает, что свойство (сопоставляемое поле списка) имеет связь с другой список, например, когда свойство сопоставляется с полем подстановки.
Общий класс AssociationChangedEventArgs<T> Предоставляет данные для событий OnChanged , EntityRef<TEntity>, EntitySet<TEntity>или Microsoft.SharePoint.Linq.LookupList<T>.
Общий класс ChangeConflictCollection Представляет коллекцию объектов ObjectChangeConflict .
Общий класс ChangeConflictException Представляет исключение, возникающее при сбое обновления, так как значения базы данных были обновлены с момента последнего их чтения клиентом.
Общий класс ChoiceAttribute Член перечисления сопоставляется значение выбора String для поля Choice или MultiChoice типа списка Microsoft SharePoint Foundation .
Общий класс ColumnAttribute Указывает, что свойство сопоставляется поля (столбца) в списке Microsoft SharePoint Foundation .
Общий класс ContentTypeAttribute Указывает, что класс сопоставляется с типом содержимого Microsoft SharePoint Foundation .
Общий класс CustomMappingAttribute Определяет, какие новые столбцы сопоставляются с методом MapFrom(Object) , оснащены атрибутом.
Общий класс DataAttribute Предоставляет два дополнительных свойства наиболее часто используемые атрибуты свойства (классов сущностей), сопоставляются с список полей (столбцов) или свойства списка.
Общий класс DataContext Предоставляет доступ LINQ (запрос) и для отслеживания изменений, списков и библиотек документов веб-узла Microsoft SharePoint Foundation .
Общий класс DerivedEntityClassAttribute Идентифицирует класс, производный от класса, к которому применяется атрибут.
Общий класс EntityList<TEntity> Представляет Microsoft SharePoint Foundation список, который может запрашиваться с Language Integrated Query (LINQ).
Общий класс EntityRef<TEntity> Обеспечивает отложенную загрузку и связь для одной стороны отношения «один ко многим».
Общий класс EntitySet<TEntity> Обеспечивает отложенную загрузку и связь для стороны «многие» отношения один ко многим "и" многие ко многим
Общий класс ListAttribute Указывает, что свойство объекта DataContext представляет список Microsoft SharePoint Foundation .
Общий класс LookupList<T> Представляет значения подстановки Microsoft SharePoint Foundation поля (столбца), позволяющая несколько значений.
Общий класс MemberChangeConflict Указывает сведения о несоответствие между значением поля (или свойства метаданных элемента списка) в базе данных и его значение в текущий процесс на внешнем веб-сервере - его значение клиента.
Общий класс ObjectChangeConflict Указывает сведения о несоответствия между текущее значение одного или нескольких полей в элемент списка клиентов и текущие значения полей базы данных.
Общий класс RemovedColumnAttribute Задает это свойство сопоставляется поля (столбца), но был удален из производного типа содержимого родительского типа содержимого.
Общий класс ResourceStrings Данный тип или элемент поддерживает Microsoft Windows SharePoint Services и не предназначен для использования непосредственно из программного кода.
Общий класс Utility Поставщик LINQ to SharePoint предоставляет различные функциональные возможности.

Интерфейсы

  Интерфейс Описание
Общий интерфейс ICustomMapping Включает расширение системы объектно реляционное сопоставление LINQ-поставщик SharePoint.
Общий интерфейс ITrackEntityState Включает участие в объект отслеживания системы LINQ поставщик SharePoint.
Общий интерфейс ITrackOriginalValues Разрешает реализации классов для хранения словарь измененных свойств и их исходные значения.

Перечисления

  Перечисление Описание
Общее перечисление AssociationChangedState Указывает, как изменяется EntityRef<TEntity>, EntitySet<TEntity>или Microsoft.SharePoint.Linq.LookupList<T> .
Общее перечисление AssociationType Указывает тип отношения подстановки между поля (столбца) в одном списке и поля в другом списке.
Общее перечисление ConflictMode Указывает, при попытке отправить изменения списка должен быть остановлен и ChangeConflictException исключение.
Общее перечисление EntityState Запись измененного состояния объекта (обычно элемент списка; но возможно сущность отсоединена).
Общее перечисление RefreshMode Указывает реакцию элемента списка, изменение системы LINQ поставщика SharePoint при нахождении, что после извлечения элемента списка были ли изменены другим процессом.