Share via

Erstellen einer SharePoint Foundation-Standardclientanwendung

  • Artikel

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.

  1. Zeigen Sie im Menü Datei auf Neu, und klicken Sie auf Projekt.

  2. 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.

  3. 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.

  4. 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.

  5. 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

  6. 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

Übersicht über den Datenabruf

Allgemeine Programmieraufgaben

Weitere Ressourcen

Clientklassenbibliothek

ECMAScript-Klassenbibliothek