设置上下文便于使用 BDC 对象模型

上次修改时间: 2010年4月15日

适用范围: 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 项目的类型时)适用。

备注

SDK 的 Business Connectivity Services 对象模型的代码段一节中的大多数示例代码都使用第二种方法,因此,如果您在为基于浏览器的应用程序编写代码,则必须更改代码。以下各节提供有关使用 Business Connectivity Services 对象模型的指南。

浏览器承载的应用程序:创建网站上下文

若要通过浏览器承载的应用程序使用 BDC,您的代码必须先创建 BDC 共享服务的上下文,该共享服务将处理对 BDC 发出的请求。

您必须在代码中获取 BDC 共享服务的 HTTP 上下文。建议您通过使用 Microsoft.SharePoint.SPServiceContext 类及其成员执行此操作。

若要返回网站使用的当前共享服务,可在创建网站上下文后使用 SPServiceContext.Current 属性。

控制台和 Windows 应用程序:使用对象构造函数

如果使用的是 DatabaseBasedMetadataCatalog 对象,则必须在控制台或基于 Windows 的应用程序中显式设置 SPServiceContext.Current 属性。BDC 假定任何调用方为其创建了 SPServiceContext.Current 属性,以便它能在内部相应地调用其他服务(如用户配置文件或Secure Store Service)。如果为任一类应用程序编写代码,并希望使用特定网站集,则使用 SPSite 构造函数对表示网站集的对象进行实例化。

警告注释警告

您的代码应释放通过使用构造函数获取的任何 SPSite 或 SPWeb 对象。对于何时应释放以及何时不应释放 SharePoint Foundation 对象,最佳做法存在许多差异。有关信息,请参阅释放对象。

Microsoft Office 2010 加载项

若要通过 Office 2010 加载项使用 BDC,则您的代码必须先获取对元数据目录的访问权。若要访问 BCS 客户端缓存,则应获取 RemoteFileBackedMetadataCatalog。在 Office 2010 加载项中,还可以使用 FileBackedMetadataCatalog。

示例

请参阅

概念

最常用的 15 个 BCS 对象模型类

其他资源

Business Connectivity Services 对象模型的代码段