Création d'une application cliente SharePoint Foundation de base
Dernière modification : mardi 3 août 2010
S’applique à : SharePoint Foundation 2010
Disponible dans SharePoint Online
Pour créer une application cliente managée .NET qui utilise le modèle objet client, vous devez définir des références vers deux DLL de bibliothèques clientes : Microsoft.SharePoint.Client.dll et Microsoft.SharePoint.Client.Runtime.dll. Vous pouvez copier ces DLL à partir du dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI du serveur qui exécute Microsoft SharePoint Foundation 2010 vers l'ordinateur distant sur lequel vous créez l'application.
Création d'une application console de base
La tâche de programmation suivante exécute pas à pas la procédure de création d'une application console de base dans Microsoft Visual Studio qui utilise les objets dans l'espace de noms Microsoft.SharePoint.Client pour retourner des propriétés de site Web.
Dans le menu Fichier, pointez vers Nouveau et cliquez sur Projet.
Dans la boîte de dialogue Nouveau projet, sélectionnez Visual Basic ou Visual C# dans la zone Modèles installés. Sélectionnez Windows, puis Application console. Choisissez .NET Framework 3.5 dans la liste déroulante située en haut de pannneau central. Tapez un nom et un emplacement pour le projet dans les zones Nom et Emplacement, puis cliquez sur OK.
Dans Windows Explorer, copiez les deux DLL à partir du dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI du serveur vers le dossier de niveau supérieur de votre application console.
Cliquez avec le bouton droit sur le projet dans l'Explorateur de solutions, cliquez sur Ajouter une référence, et dans la boîte de dialogue Ajouter une référence, cliquez sur l'onglet Parcourir pour accéder au dossier où vous avez copié Microsoft.SharePoint.Client.dll et Microsoft.SharePoint.Client.Runtime.dll. Sélectionnez les deux DLL, puis cliquez sur OK.
L'exemple suivant retourne et affiche le titre du site Web à l'URL qui est spécifiée dans le constructeur ClientContext(). La méthode Load<T>(T, []) spécifie l'objet à extraire du serveur, qui est en l'occurrence le site Web, et ExecuteQuery() exécute la requête. Dans la mesure où l'objet du site Web est chargé, toutes ses propriétés par défaut deviennent alors disponibles à l'affichage à la console. Pour des informations sur les propriétés qui ne sont pas disponibles par défaut quand vous chargez un objet ou une collection, consultez Vue d'ensemble de la récupération des données.
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
Appuyez sur F5 pour exécuter l'application et afficher le titre et la date de création du site Web sur la console.
Voir aussi
Concepts
Procédure : travailler avec des sites Web
Vue d'ensemble de la récupération des données
Tâches courantes de programmation