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.
Attention |
---|
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
Extraits de code : Utilisation du modèle objet Client SharePoint avec des listes externes
Extraits de code : exécution de méthodes à l’aide du modèle d’objet d’exécution BDC
Extraits de code : utilisation du modèle objet d’administration BDC
Extraits de code : utilisation du modèle objet de packaging de solutions BCS
Extraits de code : Création de composants de code réutilisables BCS
Extraits de code : Utilisation du modèle objet Banque sécurisée avec BCS
Extrait de code : implémentation d’un connecteur personnalisé
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