Установка контекста для использования объектных моделей BDC

Дата последнего изменения: 15 апреля 2010 г.

Применимо к: SharePoint Server 2010

В этой статье
Приложения на базе браузера: определение контекста сайта
Консольные и Windows-приложения: использование конструкторов объектов
Надстройки Microsoft Office 2010
Примеры

Чтобы использовать объектные модели Microsoft Business Connectivity Services (BCS) в развернутой среде Microsoft SharePoint Foundation, Microsoft SharePoint Server или Microsoft Office 2010, сначала в программе необходимо получить ссылку на объекты, с которыми предполагается работать, включая веб-сайты, общую службу BDC, каталог метаданных и удаленную автономную среду выполнения BDC. Это можно сделать двумя способами: один из них применяется, если программу планируется использовать в консольном или Windows-приложении, а второй — если программа предназначена для приложения на базе браузера (например, когда в качестве типа проекта Microsoft Visual Studio выбран веб-сайт).

Примечание
В большинстве образцов кода, включенных в раздел Фрагменты кода для объектной модели служб Business Connectivity Services пакета SDK, используется второй способ, поэтому в программу, разрабатываемую для приложения на основе браузера, потребуется внести изменения. В следующих разделах приводятся указания по использованию объектных моделей Business Connectivity Services.

Приложения на базе браузера: определение контекста сайта

Чтобы работать с BDC с помощью приложения на базе браузера, сначала в программе необходимо определить в качестве контекста общую службу BDC, которая должна будет обрабатывать запросы к BDC.

Необходимо получить в коде HTTP-контекст общей службы BDC. Для этого рекомендуется использовать класс Microsoft.SharePoint.SPServiceContext и его члены.

После того как контекст сайта установлен, для возвращения текущей общей службы этого сайта можно использовать свойство SPServiceContext.Current.

Консольные и Windows-приложения: использование конструкторов объектов

В консольном или Windows-приложении необходимо явным образом настроить свойство SPServiceContext.Current, если используется объект DatabaseBasedMetadataCatalog. В BDC предполагается, что каждая вызывающая программа устанавливает свойство SPServiceContext.Current, чтобы обеспечить корректный внутренний вызов других служб, таких как служба профилей пользователей или Secure Store. Если программа пишется для приложения одного из этих типов и предполагается работать с определенным семейством сайтов, используйте конструктор SPSite для создания экземпляра объекта, представляющего это семейство сайтов.

Внимание!
В программе следует уничтожить все объекты SPSite и SPWeb, полученные с помощью конструктора. На практике существует ряд нюансов, касающихся того, когда следует удалять объекты SharePoint Foundation, а когда не следует. Подробнее об этом см. в разделе Удаление объектов.

Надстройки Microsoft Office 2010

Чтобы работать с BDC с помощью надстройки Office 2010, сначала в программе необходимо получить доступ к каталогу метаданных. Для доступа к кэшу клиента BCS необходимо получить каталог RemoteFileBackedMetadataCatalog. В надстройке Office 2010 можно также использовать каталог FileBackedMetadataCatalog.

Примеры

• Фрагменты кода: получение каталога метаданных

• Фрагменты кода. Использование объектной модели списка SharePoint с внешними списками на сервере

• Фрагменты кода: использование объектной модели клиента SharePoint с внешними списками

• Фрагменты кода: выполнение методов с использованием объектной модели среды выполнения BDC

• Фрагменты кода: использование объектной модели администрирования BDC

• Фрагменты кода: использование объектной модели кэша BCS

• Фрагменты кода: использование объектной модели упаковки решений службы подключения к бизнес-данным

• Фрагменты кода: создание повторно используемых компонентов кода BCS

• Фрагменты кода. Использование объектной модели безопасного хранения с BCS

• Фрагменты кода: реализация стереотипных операций

• Фрагмент кода: реализуется настраиваемый соединитель

См. также

Концепции

15 классов объектной модели BCS верхнего уровня

Другие ресурсы

Фрагменты кода для объектной модели служб Business Connectivity Services