SharePoint 2010 client object module 方法大全
2012-10-16 17:20
633 查看
Recently I had my very first encounter with Sharepoint, and I cannot say it was a pleasant meeting. I was doing a proof of concept for a customer to manipulate Sharepoint from code using the new Sharepoint 2010 Client Object Model. Not that this is a particular unpleasant job in itself and neither is the API particulary bad (although definitely odd), but the MSDN documentation about the Client Object Model is far from self-explanatory, and lacks the – for me, at last – most crucial part of educational material: simple how-to examples.
Most examples found elsewhere are either based on older API’s, incomplete and sometimes completely wrong. And you have to roam about half the internet to get pieces of code together. So I thought it would be a good idea to cobble together pieces from the POC into a comprehensive blog post with what I’ve learned, hoping to save other people the same quest.
Be aware that I learned this all just in the past few days so things are pretty crude at times. I am by no means a Sharepoint wizard - nor am I planning on becoming one :-). The idea is just to show how it’s done. I think there are a lot of people out there who know how to do things better and more efficient than me: it just they don’t blog about it ;-)
This code was used to talk to a Sharepoint foundation on a domain controller outside the domain on which I actually ran the code.
Things covered in this post
Create a site
Retrieve a site by title
Retrieve a role by Role type
Retrieve a Sharepoint principal by Active Directory user or group name
Retrieve a document library by name
Retrieve a document library templateby name
Create a document library and set permissions
Create a folder in a document library
Upload a file to a document library
Download a file from a document library
List all folders or files in a document library
Setting the stage
It started out making a “Sharepointhelper” class. The basics of this thing is a follows:
Creating the object should go like this:
aUser must be a user with enough rights to perform sharepoint administration. I used the domain admin username and password and I assure you – that works ;-)
Create a site
Usage sample:
Retrieve a site by title
Usage sample:
Retrieve role by Role type
Usage sample:
will get you the contributor role.
Retrieve a Sharepoint principal by Active Directory user or group name
Now this one took me a very long time. For some reason there is a static Utility.SearchPrincipals method that gets you a PrincipalInfo object, but you can never get to get a Principal object that you can use for setting permissions. I spent a long time scratching my head how to get around this before I found there is another way:
Usage sample:
This will, as you can see, get you either a user group’s principal or a single user’s principal. Since I was looking for a group’s principal it never occurred to me to try the “EnsureUser” method. If you don’t know what a Principal is – neither do I (at least not exactly) but I of think it as a descriptor of a user’s or group's credentials.
Retrieve a document library by name
Usage sample:
Retrieve a document library template by name
Usage sample:
This will get you the template for the document library type.
Create a document library and set permissions
Now this was what I actually had to prove in the POC, and you can see this as it uses a lot of the previous samples:
Usage sample:
Which will create a document library “myDocumentLibrary” in “MySite” with a contributor role for “MyUserGroup”. Like I said, it’s pretty crude still here and there, but you get the idea
Create a folder in a document library
I'll skip the usage sample here, as I suppose it's pretty self-explanatory now.
Upload a file to a document library
Usage sample:
This will upload the file c:\temp\sample.png as "sample.png" in the "myDocumentLibrary" library.
Download a file from a document library
What goes up must come down, eh? This one is a bit odd, as it strips the directory name of the target file and tries to find the file in Sharepoint with it, but it works, so what:
Usage sample:
will search for the file "sample.png" in "myDocumentLibrary" and try to download that to c:\temp
Listing files or folders in a document library
And finally:
and if you don’t mind, I’ll skip the usage samples here as well.
Most examples found elsewhere are either based on older API’s, incomplete and sometimes completely wrong. And you have to roam about half the internet to get pieces of code together. So I thought it would be a good idea to cobble together pieces from the POC into a comprehensive blog post with what I’ve learned, hoping to save other people the same quest.
Be aware that I learned this all just in the past few days so things are pretty crude at times. I am by no means a Sharepoint wizard - nor am I planning on becoming one :-). The idea is just to show how it’s done. I think there are a lot of people out there who know how to do things better and more efficient than me: it just they don’t blog about it ;-)
This code was used to talk to a Sharepoint foundation on a domain controller outside the domain on which I actually ran the code.
Things covered in this post
Create a site
Retrieve a site by title
Retrieve a role by Role type
Retrieve a Sharepoint principal by Active Directory user or group name
Retrieve a document library by name
Retrieve a document library templateby name
Create a document library and set permissions
Create a folder in a document library
Upload a file to a document library
Download a file from a document library
List all folders or files in a document library
Setting the stage
It started out making a “Sharepointhelper” class. The basics of this thing is a follows:
using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Net; using System.Reflection; using System.Security.Principal; using System.Text; using Microsoft.SharePoint.Client; using Microsoft.SharePoint.Client.Utilities; using File = Microsoft.SharePoint.Client.File; namespace TestSharepoint { public class SharepointHelper { private ClientContext clientContext; private Web rootWeb; public SharepointHelper(string url, string username, string password) { clientContext = new ClientContext(url); var credentials = new NetworkCredential(username, password, "domain"); clientContext.Credentials = credentials; rootWeb = clientContext.Web; clientContext.Load(rootWeb); } } }
Creating the object should go like this:
var sh = new SharepointHelper("http://yourserver", "aUser", "hisPassword");
aUser must be a user with enough rights to perform sharepoint administration. I used the domain admin username and password and I assure you – that works ;-)
Create a site
public void CreateSite(string siteDescription, string siteTitle, string siteUrl) { rootWeb = rootWeb.Webs.Add(new WebCreationInformation { Description = siteDescription, Title = siteTitle, Url = siteUrl, UseSamePermissionsAsParentSite = false }); clientContext.ExecuteQuery(); }
Usage sample:
sh.Create("My site description", "MySite", "mysiteurl");
Retrieve a site by title
public Web GetWebByTitle(string siteTitle) { var query = clientContext.LoadQuery( rootWeb.Webs.Where(p => p.Title == siteTitle)); clientContext.ExecuteQuery(); return query.FirstOrDefault(); }
Usage sample:
var w = sh.GetWebByTitle("MySite");
Retrieve role by Role type
private RoleDefinition GetRole(string siteTitle, RoleType rType) { var web = GetWebByTitle(siteTitle); if (web != null) { var roleDefs = web.RoleDefinitions; var query = clientContext.LoadQuery( roleDefs.Where(p => p.RoleTypeKind == rType)); clientContext.ExecuteQuery(); return query.FirstOrDefault(); } return null; }
Usage sample:
var r = sh.GetRole("MySite", RoleType.Contributor);
will get you the contributor role.
Retrieve a Sharepoint principal by Active Directory user or group name
Now this one took me a very long time. For some reason there is a static Utility.SearchPrincipals method that gets you a PrincipalInfo object, but you can never get to get a Principal object that you can use for setting permissions. I spent a long time scratching my head how to get around this before I found there is another way:
public Principal GetPrincipal(string name) { if (web != null) { try { var principal = web.EnsureUser(name); clientContext.Load(principal); clientContext.ExecuteQuery(); if (principal != null) { return principal; } } catch (ServerException){} } return null; }
Usage sample:
var g = sh.GetPrincipal("MyUserGroup"); var u = sh.GetPrincipal("MyUser");
This will, as you can see, get you either a user group’s principal or a single user’s principal. Since I was looking for a group’s principal it never occurred to me to try the “EnsureUser” method. If you don’t know what a Principal is – neither do I (at least not exactly) but I of think it as a descriptor of a user’s or group's credentials.
Retrieve a document library by name
public List GetDocumentLibrary(string siteTitle, string libraryName) { var web = GetWebByTitle(siteTitle); if (web != null) { var query = clientContext.LoadQuery( web.Lists.Where(p => p.Title == libraryName)); clientContext.ExecuteQuery(); return query.FirstOrDefault(); } return null; }
Usage sample:
var g = GetDocumentLibrary("MySite", "myDocumentLibrary");
Retrieve a document library template by name
public ListTemplate GetDocumentLibraryTemplate(Web web, string name) { ListTemplateCollection ltc = web.ListTemplates; var listTemplates = clientContext.LoadQuery( ltc.Where(p => p.InternalName == name)); clientContext.Load(ltc); clientContext.ExecuteQuery(); return listTemplates.FirstOrDefault(); }
Usage sample:
var t = sh.GetDocumentLibraryTemplate(web, "doclib");
This will get you the template for the document library type.
Create a document library and set permissions
Now this was what I actually had to prove in the POC, and you can see this as it uses a lot of the previous samples:
public bool CreateDocumentLibrary(string siteTitle, string libraryName, string libraryDescription, string userGroup) { var web = GetWebByTitle(siteTitle); if (web != null) { // First load all the list var lists = web.Lists; clientContext.Load(lists); clientContext.ExecuteQuery(); // Create new lib based upon the doclib template var newList = lists.Add(new ListCreationInformation { Title = libraryName, Description = libraryDescription, TemplateType = GetDocumentLibraryTemplate(web, "doclib").ListTemplateTypeKind }); clientContext.ExecuteQuery(); // Override default permission inheritance newList.BreakRoleInheritance(true, false); // Get principal for usergroup and the contributor role var principal = GetPrincipal(userGroup); var role = GetRole(siteTitle, RoleType.Contributor); // Add the role to the collection. var collRdb = new RoleDefinitionBindingCollection(clientContext) {role}; var collRoleAssign = newList.RoleAssignments; collRoleAssign.Add(principal, collRdb); clientContext.ExecuteQuery(); return true; } return false; }
Usage sample:
var result = sh.CreateDocumentLibrary("MySite", "myDocumentLibrary", "A very nice library", "MyUserGroup");
Which will create a document library “myDocumentLibrary” in “MySite” with a contributor role for “MyUserGroup”. Like I said, it’s pretty crude still here and there, but you get the idea
Create a folder in a document library
public void CreateFolder( string siteTitle, string libraryName, string folder) { var list = GetDocumentLibrary(siteTitle, libraryName); if (list != null) { var folders = list.RootFolder.Folders; clientContext.Load(folders); clientContext.ExecuteQuery(); var newFolder = folders.Add(folder); clientContext.ExecuteQuery(); } }
I'll skip the usage sample here, as I suppose it's pretty self-explanatory now.
Upload a file to a document library
public void UploadDocument( string siteTitle, string libraryName, string fileName ) { var web = GetWebByTitle(siteTitle); var fInfo = new FileInfo(fileName); var targetLocation = string.Format("{0}/{1}/{2}", web.ServerRelativeUrl, libraryName, fInfo.Name); using (var fs = new FileStream(fileName, FileMode.Open)) { File.SaveBinaryDirect(clientContext, targetLocation, fs, true); } }
Usage sample:
var result = sh.UploadDocument("MySite", "myDocumentLibrary", @"c:\temp\sample.png");
This will upload the file c:\temp\sample.png as "sample.png" in the "myDocumentLibrary" library.
Download a file from a document library
What goes up must come down, eh? This one is a bit odd, as it strips the directory name of the target file and tries to find the file in Sharepoint with it, but it works, so what:
public void DownloadDocument(string siteTitle, string libraryName, string fileName) { var web = GetWebByTitle(siteTitle); var fInfo = new FileInfo(fileName); var source = string.Format("{0}/{1}/{2}", web.ServerRelativeUrl, libraryName, fInfo.Name); var spFileInfo = File.OpenBinaryDirect(clientContext, source); using (var fs = new FileStream(fileName, FileMode.OpenOrCreate)) { spFileInfo.Stream.CopyTo(fs); } }
Usage sample:
sh.DownloadDocument("MySite", "myDocumentLibrary", @"c:\temp\sample.png");
will search for the file "sample.png" in "myDocumentLibrary" and try to download that to c:\temp
Listing files or folders in a document library
And finally:
public List<File> ListFiles(string siteTitle, string libraryName) { var list = GetDocumentLibrary(siteTitle, libraryName); var files = list.RootFolder.Files; clientContext.Load(files); clientContext.ExecuteQuery(); return files.ToList(); } public List<Folder> ListFolders(string siteTitle, string libraryName) { var list = GetDocumentLibrary(siteTitle, libraryName); var folders = list.RootFolder.Folders; clientContext.Load(folders); clientContext.ExecuteQuery(); return folders.ToList(); }
and if you don’t mind, I’ll skip the usage samples here as well.
相关文章推荐
- [SharePoint 2010] Javascript Client Object Model 在SharePoint2010中的使用方法
- [SharePoint 2010] Client Object Model 跨时区查询list item的方法
- [SharePoint 2010] Client Object Model 跨时区查询list item的方法
- SharePoint 2010 匿名用户调用Client Object Model访问列表项
- 如何开启匿名访问SharePoint 2010里的Client Object Model
- SharePoint 2010 Client Object Model-Client API
- Sharepoint 2010 client object model
- SharePoint 2010新特性使用Client Object Model在客户端开发
- 使用Jscex增强SharePoint 2010 JavaScript Client Object Model (JSOM)
- [转]SharePoint 2010: Client Object Model for JavaScript (ECMAScript)(使用客户端对象模型)
- SharePoint 2010 Client Object Model - JavaScript(ECMAScript)
- 如何开启匿名访问SharePoint 2010里的Client Object Model
- SharePoint 2010新特性使用Client Object Model在客户端开发
- SharePoint 2010 - Client Object Model - ECMAScript
- 使用 SharePoint 2010 Client Object Model 修改用户Email(邮箱) 地址
- 如何开启匿名访问SharePoint 2010里的Client Object Model
- sharepoint 2010 "若要在 Visual Studio 中与 SharePoint 项目进行交互,您的系统用户帐户必须拥有管理员特权。"的解决方法
- Using the SharePoint 2010 Client Object Model_part_4
- SharePoint 2010 自定义Timer job 问题总结(拒绝访问,Execute方法不执行,不及时更新)
- Visual Studio 2010快捷键实用方法技能大全