Partager via


Définition du contexte pour l’utilisation des modèles objet BDC

Dernière modification : jeudi 15 avril 2010

S’applique à : SharePoint Server 2010

Dans cet article
Applications hébergées dans un navigateur : établir un contexte de site
Applications console et Windows : utiliser des constructeurs d’objets
Compléments Microsoft Office 2010
Exemples

Pour utiliser les modèles objet Microsoft Business Connectivity Services (BCS) avec un déploiement de Microsoft SharePoint Foundation, Microsoft SharePoint Server ou Microsoft Office 2010, votre code doit d’abord obtenir une référence aux objets avec lesquels il travaillera, notamment les sites Web, le service partagé BDC, le catalogue de métadonnées et le runtime hors connexion à distance BDC. Il existe deux manières de procéder : l’une est applicable lorsque votre code sera utilisé dans une console ou une application Windows ; l’autre est applicable lorsque votre code sera utilisé dans une application hébergée dans un navigateur, comme par exemple lorsque vous choisissez « Site Web » comme type de projet Microsoft Visual Studio.

Notes

La plupart des exemples de code dans la section Extraits de code du modèle objet des services Business Connectivity du Kit de développement logiciel SDK utilisent la seconde approche. Par conséquent, si vous écrivez pour une application basée sur navigateur, vous devez modifier le code. Les sections suivantes fournissent une aide à l’utilisation des modèles objet Business Connectivity Services.

Applications hébergées dans un navigateur : établir un contexte de site

Pour travailler avec le service BDC à l’aide d’une application hébergée dans un navigateur, votre code doit d’abord établir le contexte du service partagé BDC qui doit gérer les demandes envoyées au service BDC.

Vous devez obtenir le contexte HTTP du service partagé BDC dans le code. Nous vous recommandons d’utiliser pour cela la classe Microsoft.SharePoint.SPServiceContext et ses membres.

Pour renvoyer le service partagé actuel utilisé par un site, vous pouvez utiliser la propriété SPServiceContext.Current après avoir établi le contexte de site.

Applications console et Windows : utiliser des constructeurs d’objets

La propriété SPServiceContext.Current doit être définie explicitement dans une application console ou Windows si vous utilisez l’objet DatabaseBasedMetadataCatalog. Le service BDC suppose qu’il existe une propriété SPServiceContext.Current établie par tout appelant, afin de pouvoir appeler de manière appropriée d’autres services tels que Profils utilisateur ou le Service Banque d’informations sécurisé en interne. Si vous écrivez du code pour l’un ou l’autre type d’application et que vous souhaitez travailler avec une collection de sites spécifique, utilisez le constructeur SPSite pour instancier un objet qui représente la collection de sites.

Note AttentionAttention

Votre code doit supprimer tout objet SPSite ou SPWeb obtenu à l’aide d’un constructeur. Les meilleures pratiques sont quelque peu nuancées en ce qui concerne la suppression des objets SharePoint Foundation. Pour plus d’informations, voir Suppression d’objets.

Compléments Microsoft Office 2010

Pour travailler avec le service BDC au moyen d’un complément Office 2010, votre code doit tout d’abord obtenir l’accès à un catalogue de métadonnées. Si vous souhaitez accéder au cache client BCS, vous devez obtenir l’objet RemoteFileBackedMetadataCatalog. Dans un complément Office 2010, vous pouvez également utiliser le fichier FileBackedMetadataCatalog.

Exemples

Voir aussi

Concepts

15 classes de modèle objet BCS les plus importantes

Autres ressources

Extraits de code du modèle objet des services Business Connectivity