La structure interne ainsi que le design d'AreaProg ont récemment été modifiés.
Suite à cela, le format de certains articles a été perturbé. Le problème est connu et en cours de résolution. Merci de votre compréhension.
Tout comme le cours précédent, celui-ci ne va pas être très long. Effectivement, un objet du type SPWeb représente une notion tellement importante et complexe qu'il serait impossible d'aborder toutes les méthodes et propriétés d'un tel objet dans un seul et même cours. Alors qu'un objet du type SPSite représente une instance d'une collection de sites, un objet du type SPWeb représente une instance d'un site web. Comme vous pouvez l'imaginez, un tel objet contient un nombre incalculable de méthodes et de propriétés. Imaginez le nombre de propriétés attachées à un site. Il y en a des dizaines. Dans ce cours, nous allons voir la manière la plus simpliste d'utiliser un objet SPWeb ainsi que 4 de ces nombreuses propriétés. Nous utiliserons cet objet tout au long de nos cours, vous apprendrez donc à l'utiliser au fur et à mesure de votre lecture. Sachez tout d'abord que l'on ne crée pas un objet SPWeb à l'aide d'un constructeur. Effectivement, cette classe ne possède pas de constructeur utilisable, nous devons passer (le plus généralement) par un objet du type SPSite. Effectivement, nous allons d'abord devoir récupérer une instance vers la collection de site contenant celui que l'on veut ouvrir. Une fois cette instance récupérée, nous utilisons la fonction OpenWeb de l'objet en question pour récupérer une instance du site que nous voulons. Voyons cela par un exemple. Commencez par créer une nouvelle application console dans Visual Studio 2008. Nous allons ensuite devoir ajouter une référence à l'API SharePoint pour avoir accès à l'object model. Pour cela, cliquez avec le bouton droit sur le dossier References de votre projet et cliquez sur Add Reference. Dans la fenêtre qui apparaît, allez chercher Windows SharePoint Services :
Ajoutez ensuite cette directive à votre classe :
using Microsoft.SharePoint;
Vous êtes maintenant capable d'accèder à l'Object Model de SharePoint. Nous allons tout d'abord commencer par récupérer une référence à la collection de site contenant celui que nous désirons utiliser. Tapez donc :
using (SPSite site = new SPSite("http://pc-de-zick"))
{
}
Ici, vous devrez bien entendu remplacer http://pc-de-zick par l'adresse de la collection de site que vous voulez utiliser. Nous allons maintenant utiliser la fonction OpenWeb de cet objet pour récupérer une instance du site web en question. Dans la clause using de l'objet SPSite, tapez ceci :
using (SPWeb web = site.OpenWeb())
{
Console.WriteLine("Nombre d'alerte : " + web.Alerts.Count);
Console.WriteLine("Nombre d'utilisateurs présente : " + web.AllUsers.Count);
Console.WriteLine("Nombre de liste : " + web.Lists.Count);
Console.WriteLine("URL : " + web.Url);
Console.ReadLine();
}
Comme nous l'avons dit, nous récupérons la référence renvoyée par la fonction OpenWeb de l'objet site dans un objet appelé web de type SPWeb. Encore une fois, utiliser un objet du type SPWeb va nécessiter beaucoup de ressources, il est donc nécessaire de libérer la mémoire de cet objet immédiatement après son utilisation. Pour nous assurer cela, nous le déclarons dans une clause using qui permettra à cet objet d'être détruit immédiatement à la fin de la clause using. Ensuite, nous affichons la valeur de 4 propriétés. La première d'entre elle est la collection Alerts. Cette collection contient une liste des alertes présentes sur le site. Ici, nous nous contentons d'afficher le nombre d'alerte que contient cette collection. Nous utilisons ensuite la colleciton AllUsers qui contient la liste de tous les utilisateurs liés au site web. Encore une fois, nous affichons le nombre d'utilisateurs contenus dans cette collection. Nous affichons également le nombre d'éléments contenus dans la collection Lists. Cette collection est très importante, elle contient les différentes listes présentes sur le site web. Lorsque vous voudrez récupérer des éléments d'une liste, en ajouter ou autre, il vous faudra passer par cette collection. Enfin, nous affichons simplement l'URL du site dont la référence est contenue dans l'objet web. Au final, vous devriez obtenir quelque chose dans ce style :
Bien entendu, les valeurs chez vous seront différentes que dans la capture d'écran. Nous allons maintenant pouvoir passer à l'étude plus approfondie de l'Object Model. Rendez vous donc dans les prochains cours.
Veuillez vous identifier ou vous inscrire pour donner une note à cet article.
Aucun commentaire.
Veuillez vous identifier ou vous inscrire pour réagir à cet article.