Erstellen einer SharePoint Foundation-Standardclientanwendung
Letzte Änderung: Dienstag, 3. August 2010
Gilt für: SharePoint Foundation 2010
Verfügbar in SharePoint Online
Wenn Sie eine verwaltete .NET-Clientanwendung erstellen möchten, die das Clientobjektmodell verwendet, müssen Sie Verweise auf zwei Clientbibliotheks-DLLs festlegen: Microsoft.SharePoint.Client.dll und Microsoft.SharePoint.Client.Runtime.dll. Sie können diese DLLs aus dem %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI-Ordner auf dem Server mit Microsoft SharePoint Foundation 2010 auf den Remotecomputer kopieren, auf dem Sie die Anwendung erstellen.
Erstellen einer Standardkonsolenanwendung
In der folgenden Programmieraufgabe werden Sie schrittweise durch das Verfahren zum Erstellen einer Standardkonsolenanwendung in Microsoft Visual Studio geführt, die Objekte im Microsoft.SharePoint.Client-Namespace zum Zurückgeben von Websiteeigenschaften verwendet.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie auf Projekt.
Wählen Sie im Dialogfeld Neues Projekt im Feld Installierte Vorlagen die Option Visual Basic oder Visual C# aus. Wählen Sie zunächst Windows und dann Konsolenanwendung aus. Wählen Sie danach in der Dropdownliste oben im mittleren Bereich .NET Framework 3.5 aus. Geben Sie einen Namen und Speicherort für das Projekt in die Felder Name und Speicherort ein, und klicken Sie dann auf OK.
Kopieren Sie in Windows Explorer die beiden DLLs aus dem %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI-Ordner des Servers in den Ordner auf oberster Ebene der Konsolenanwendung.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, klicken Sie auf Verweis hinzufügen, und klicken Sie im Dialogfeld Verweis hinzufügen auf die Registerkarte Durchsuchen. Navigieren Sie dann zum Ordner, in den Sie Microsoft.SharePoint.Client.dll und Microsoft.SharePoint.Client.Runtime.dll kopiert haben. Wählen Sie die beiden DLLs aus, und klicken Sie auf OK.
Im folgenden Beispiel wird der Titel der Website an der URL zurückgegeben und angezeigt, die im ClientContext()-Konstruktor angegeben ist. Die Load<T>(T, [])-Methode gibt an, welches Objekt vom Server abgerufen werden soll, wobei es sich in diesem Fall um die Website handelt, und die Abfrage wird von ExecuteQuery() ausgeführt. Da das Websiteobjekt geladen wird, stehen alle Standardeigenschaften zur Anzeige in der Konsole zur Verfügung. Informationen zu Eigenschaften, die beim Laden eines Objekts oder einer Auflistung nicht standardmäßig verfügbar sind, finden Sie unter Übersicht über den Datenabruf.
using System; using Microsoft.SharePoint.Client; namespace Microsoft.SDK.SharePointServices.Samples { class DisplayWebTitle { static void Main() { ClientContext clientContext = new ClientContext("http://MyServer/sites/MySiteCollection/MyWebSite"); Web oWebsite = clientContext.Web; clientContext.Load(oWebsite); clientContext.ExecuteQuery(); Console.WriteLine("Title: {0} Created: {1}", oWebsite.Title, oWebsite.Created); } } }
Imports System Imports Microsoft.SharePoint.Client Namespace Microsoft.SDK.SharePointServices.Samples Class DisplayWebTitle Public Overloads Shared Sub Main() Dim clientContext As New ClientContext("http://MyServer/sites/MySiteCollection/MyWebSite") Dim oWebsite As Web = clientContext.Web clientContext.Load(oWebsite) clientContext.ExecuteQuery() Console.WriteLine("Title: {0} Created: {1}", oWebsite.Title, oWebsite.Created) End Sub End Class End Namespace
Drücken Sie F5, um die Anwendung auszuführen und den Titel sowie das Erstellungsdatum der Website in der Konsole anzuzeigen.
Siehe auch
Konzepte
Gewusst wie: Arbeiten mit Websites
Allgemeine Programmieraufgaben