Richtlinien für Webdienste
Letzte Änderung: Mittwoch, 7. Juli 2010
Gilt für: SharePoint Foundation 2010
Die vom Microsoft.SharePoint.SoapServer-Namespace bereitgestellten Microsoft SharePoint Foundation-Webdienste umfassen Methoden für den Zugriff auf den Inhalt einer Website, z. B. zum Arbeiten mit Listen oder Websitedaten, sowie Methoden zum Anpassen von Besprechungen, Bildverarbeitung, Dokumentarbeitsbereichen oder Suchvorgängen.
.gif "Wichtiger Hinweis") Wichtig |
|---|
Es wird empfohlen, für die Arbeit mit Remotedaten statt der hier beschriebenen herkömmlichen ASP.NET-Webdienste möglichst immer das neue clientseitige ObjektmodellSharePoint Foundation zu verwenden. |
In diesen Diensten verwendete SOAP-Schnittstellen bieten Microsoft .NET Framework-Entwicklern Objektmodelle zum Erstellen von Lösungen, die mit SharePoint Foundation remote über einen Client oder eine benutzerdefinierte Anwendung ausgeführt werden können. Die Schnittstellen werden über das serverseitige Objektmodell der Microsoft.SharePoint-Assembly definiert, und ihr Entwurf wurde optimiert, um die Anzahl der Roundtrips zwischen Clientcomputer und Server zu verringern.
Die Funktionen der meisten Webdienste werden über das virtuelle Verzeichnis /_vti_bin bereitgestellt, das dem physischen Verzeichnis %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI im Dateisystem zugeordnet ist. Der Verwaltungswebdienst verwendet das virtuelle Verzeichnis /_vti_adm, das %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ADMISAPI zugeordnet ist.
.gif "Hinweis") Hinweis |
|---|
SharePoint Foundation erfordert keine Implementierung einer bestimmten Version von SOAP. Die SOAP-Antwort in einer beliebigen Transaktion mit SharePoint Foundation wird von .NET Framework verwaltet. |
Richtlinien für die Verwendung der ASP.NET-Webdienste
Sie können in Microsoft Visual Studio ein Projekt, z. B. eine Windows Forms-Anwendung oder eine Konsolenanwendung, erstellen, das für die Interaktion mit SharePoint-Website- und Listendaten einen SharePoint Foundation-Webdienst verwendet. Nachdem Sie ein Projekt erstellt haben, müssen Sie einen Verweis auf den Webdienst festlegen, den Sie im Code implementieren möchten, indem Sie den vollständigen Pfad des Webdiensts relativ zu der Website, die die Daten enthält, angeben.
So fügen Sie in Visual Studio einen Verweis auf einen SharePoint Foundation-Webdienst hinzu
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und klicken Sie dann auf Dienstverweis hinzufügen.
Klicken Sie im Dialogfeld Dienstverweis hinzufügen auf Erweitert, und klicken Sie im Dialogfeld Dienstverweiseinstellungen auf Webverweis hinzufügen.
Geben Sie im Dialogfeld Webverweis hinzufügen für URL die absolute URL des Webdiensts ein, indem Sie einen Pfad angeben, der die Website enthält, für die der Webdienst verfügbar ist. Wenn Sie beispielsweise einen Verweis auf den Listenwebdienst hinzufügen möchten, geben Sie einen Pfad im folgenden Format an:
http://MyServer/[sites/][MySite/][MySubsite/]_vti_bin/Lists.asmxWenn Sie stattdessen Methoden im Verwaltungswebdienst verwenden, geben Sie wie folgt einen Pfad zum Verwaltungsport an, in dem _vti_adm als virtuelles Verzeichnis verwendet wird.
http://MyServer:Port_Number/_vti_adm/Admin.asmxEine Liste von ASP.NET-Standardwebdiensten, die mit SharePoint Foundation bereitgestellt werden, finden Sie unter SharePoint Foundation 2010-Webdienste.
Geben Sie einen Webverweis ein, und klicken Sie dann auf Verweis hinzufügen.
Instanziieren eines Diensts
Instanziieren Sie in Code einen Webdienst mithilfe eines Konstruktors wie folgt: Web_Reference.Service_NameServiceInstance = new Web_Reference.Service_Name(). Web_Reference stellt den in Visual Studio für den Verweis auf den Webdienst verwendeten Namen dar, und Service_Name stellt den Namen der Klasse dar, die Methoden bereitstellt, die über den Webdienst aufgerufen werden können.
Einrichten von Benutzeranmeldeinformationen
Um Systemanmeldeinformationen für den aktuellen Sicherheitskontext, in dem die Anwendung ausgeführt wird, einzurichten, fügen Sie nach der vorherigen Zeile die folgende Zeile hinzu. In dieser wird der Benutzer oder die Gruppe, unter dem bzw. der der Code ausgeführt wird, authentifiziert, indem ihre Standardanmeldeinformationen aus dem Anmeldeinformationscache an den Webdienst übergeben werden.
ServiceInstance.Credentials = System.Net.CredentialCache.DefaultCredentials
ServiceInstance.Credentials = System.Net.CredentialCache.DefaultCredentials;
Programmieraufgaben
Mit den folgenden einfachen Programmieraufgaben wird die Verwendung eines der in SharePoint Foundation bereitgestellten standardmäßigen Webdienste veranschaulicht:
Gewusst wie: Hinzufügen von Benutzern zu einer Gruppe
Gewusst wie: Zurückgeben von Listen
Gewusst wie: Zurückgeben von Listenelementen
Gewusst wie: Aktualisieren von Listenelementen
Gewusst wie: Anpassen von Besprechungsarbeitsbereichen mit dem Meetings-Webdienst
Gewusst wie: Entfernen einer Besprechung aus einem Besprechungsarbeitsbereich
Informationen zum Erstellen eines benutzerdefinierten ASP.NET-Webdiensts, der das serverseitige Objektmodell von SharePoint Foundation implementiert, finden Sie unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten ASP.NET-Webdiensts. Informationen zum Erstellen eines benutzerdefinierten WCF-Diensts, der das Objektmodell implementiert, finden Sie unter Exemplarische Vorgehensweise: Erstellen und Implementieren eines benutzerdefinierten WCF-Diensts in SharePoint Foundation. Dies ist das empfohlene Verfahren zum Erstellen eines Webdiensts in SharePoint Foundation.