Freigeben über

Festlegen des Kontexts für die Verwendung der BDC-Objektmodelle

  • Artikel

Letzte Änderung: Donnerstag, 15. April 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Im Browser gehostete Anwendungen: Einrichten des Websitekontexts
Konsolen- und Windows-Anwendungen: Verwenden von Objektkonstruktoren
Microsoft Office 2010-Add-Ins
Beispiele

Für die Verwendung der Objektmodelle von Microsoft Business Connectivity Services (BCS) mit einer Bereitstellung von Microsoft SharePoint Foundation, Microsoft SharePoint Server oder Microsoft Office 2010 ist für den Code zunächst ein Verweis auf die verwendeten Objekte erforderlich, einschließlich Websites, freigegebenem BDC-Dienst, Metadatenkatalog und BDC-Remoteofflinelaufzeit. Hierfür gibt es zwei Methoden, wobei eine Methode für die Verwendung des Codes in einer Konsole oder Windows-basierten Anwendung und die andere Methode für die Verwendung des Codes in einer im Browser gehosteten Anwendung gilt, z. B. wenn Sie "Website" als Microsoft Visual Studio-Projekttyp auswählen.

HinweisHinweis

Für den Großteil des Beispielcodes im Abschnitt Codeausschnitte zum Business Connectivity Services-Objektmodell des SDK wird die zweite Methode verwendet. Wenn Sie also Code für eine browserbasierte Anwendung schreiben, müssen Sie den Code ändern. In den folgenden Abschnitten finden Sie Anweisungen zur Verwendung der Objektmodelle von Business-Konnektivitätsdienste (Business Connectivity Services).

Im Browser gehostete Anwendungen: Einrichten des Websitekontexts

Zum Arbeiten mit BDC mithilfe einer im Browser gehosteten Anwendung muss für den Code zunächst der Kontext für den freigegebenen BDC-Dienst eingerichtet werden, von dem die Anforderungen für BDC ausgeführt werden.

Sie müssen den HTTP-Kontext des freigegebenen BDC-Diensts im Code abrufen. Es wird empfohlen, dazu die Microsoft.SharePoint.SPServiceContext-Klasse und deren Member zu verwenden.

Zum Zurückgeben des aktuellen freigegebenen Diensts, der von einer Website verwendet wird, können Sie die SPServiceContext.Current-Eigenschaft verwenden, nachdem Sie den Websitekontext eingerichtet haben.

Konsolen- und Windows-Anwendungen: Verwenden von Objektkonstruktoren

Die SPServiceContext.Current-Eigenschaft muss explizit in einer Konsolen- oder Windows-basierten Anwendung eingerichtet werden, wenn Sie das DatabaseBasedMetadataCatalog-Objekt verwenden. BDC geht davon aus, dass eine SPServiceContext.Current-Eigenschaft von Aufrufern eingerichtet wird, sodass andere Dienste wie z. B. das Benutzerprofil oder Einmaliges Anmelden intern ordnungsgemäß aufgerufen werden können. Wenn Sie Code für einen der Anwendungstypen schreiben und eine bestimmte Websitesammlung verwenden möchten, instanziieren Sie mithilfe des SPSite-Konstruktors ein Objekt, das die Websitesammlung darstellt.

VorsichtVorsicht

Im Code sollten SPSite- oder SPWeb-Objekte verworfen werden, die mithilfe eines Konstruktors abgerufen werden. Es gibt eine Reihe von Abstufungen bei den bewährten Methoden im Hinblick auf die Frage, wann SharePoint Foundation-Objekte verworfen werden sollten. Weitere Informationen finden Sie unter Verwerfen von Objekten.

Microsoft Office 2010-Add-Ins

Für das Arbeiten mit BDC mithilfe eines Office 2010-Add-Ins muss mit dem Code zunächst auf einen Metadatenkatalog zugegriffen werden. Wenn Sie auf den BCS-Clientcache zugreifen möchten, sollten Sie RemoteFileBackedMetadataCatalog abrufen. In einem Office 2010-Add-In können Sie auch FileBackedMetadataCatalog verwenden.

Beispiele

Siehe auch

Konzepte

Die 15 wichtigsten Klassen des BCS-Objektmodells

Weitere Ressourcen

Codeausschnitte zum Business Connectivity Services-Objektmodell