Setting the Context for Using the BDC Object Models

Applies to: SharePoint Server 2010

In this article
Browser-Hosted Applications: Establish Site Context
Console and Windows Applications: Use Object Constructors
Microsoft Office 2010 Addins
Examples

To use the Microsoft Business Connectivity Services (BCS) object models with a deployment of Microsoft SharePoint Foundation, Microsoft SharePoint Server, or Microsoft Office 2010, your code must first get a reference to the objects it will be working with, including Web sites, BDC Shared Service, Metadata Catalog, and BDC Remote Offline Runtime. There are two ways for doing this: one applies when your code will be used in a console or Windows-based application; the other applies when your code will be used in a browser-hosted application, such as when you choose "Web Site" as the type of Microsoft Visual Studio project.

Note

Most sample code in the Business Connectivity Services Object Model Code Snippets section of the SDK uses the second way, so if you are writing for a browser-based application, you must change the code. The following sections provide guidance for using the Business Connectivity Services object models.

Browser-Hosted Applications: Establish Site Context

To work with the BDC by means of a browser-hosted application, your code must first establish the context to the BDC Shared Service that should handle the requests that are made to the BDC.

You must obtain the HTTP context of the BDC Shared Service in the code. We recommend that you do this by using the Microsoft.SharePoint.SPServiceContext class and its members.

To return the current shared service used by a site, you can use the SPServiceContext.Current property after you have established the site context.

Console and Windows Applications: Use Object Constructors

The SPServiceContext.Current property must be set up explicitly in a console or Windows-based application if you are using the DatabaseBasedMetadataCatalog object. BDC assumes that there is an SPServiceContext.Current property established by any callers to it so that it can appropriately call other services such as User Profile or Secure Store Service internally. If you are writing code for either type of application and you want to work with a specific site collection, use the SPSite constructor to instantiate an object that represents the site collection.

Warning

Your code should dispose any SPSite or SPWeb object obtained by using a constructor. There are a number of nuances to the best practices with regard to when SharePoint Foundation objects should and should not be disposed. For information, see Disposing Objects.

Microsoft Office 2010 Addins

To work with the BDC by means of an Office 2010 addin, your code must first get access to a metadata catalog. If you want to access the BCS Client Cache, you should get the RemoteFileBackedMetadataCatalog. In an Office 2010 addin, you can also use a FileBackedMetadataCatalog.

Examples

• Code Snippets: Getting the Metadata Catalog

• Code Snippets: Using the SharePoint List Object Model with External Lists on the Server

• Code Snippets: Using the SharePoint Client Object Model with External Lists

• Code Snippets: Executing Methods Using the BDC Runtime Object Model

• Code Snippets: Using the BDC Administration Object Model

• Code Snippets: Using the BCS Cache Object Model

• Code Snippets: Using the BCS Solution Packaging Object Model

• Code Snippets: Creating BCS Reusable Code Components

• Code Snippets: Using the Secure Store Object Model with BCS

• Code Snippets: Implementing Stereotyped Operations

• Code Snippet: Implementing a Custom Connector

See Also

Concepts

Top 15 BCS Object Model Classes

Other Resources

Business Connectivity Services Object Model Code Snippets