SharePoint客户端开发：增加用户信息到用户信息列表

285572001

　　用户信息列表（User Information List），这个隐藏的SharePoint列表，主要用来储存一些用户Profile的基本数据。这个列表不能使用普通的方式去添加或者删除数据。
　　首先，为什么要在这个列表中增加数据？
　　这个列表是由SharePoint进行管理的，在使用PeoplePicker控件的时候，点 时候就会自动把用户添加进用户信息列表。对于列表中的用户类型的字段来说，这个会利用ID关联到用户信息列表。
　　我碰到过2个典型场景：

• 实际用户操作中，对于批量数据导入的时候，一般使用的是Datasheet View，通过Excel导入。如果张三从来没有访问过网站，导入的时候有张三这个人，这个时候Datasheet View就会报错。无法保存。
  
• 开发跨站点集的数据迁移同步，张三是A网站用户，却不是B网站用户，需要把涉及到张三的数据迁移到B网站。
  

　　对于第一个场景，可以让用户随便找个PeoplePicker控件，输入缺失的人信息，然后点 ，就可以补充回来。
　　
　　对于开发者，一般情况下，服务端开发，可以用SPWeb.EnsureUser来添加用户到这个列表中。
　　对应客户端开发：

• SharePoint 2010以后的版本，Client OM也有与之对应的Web.EnsureUser方法。
  
• 传统的Web Service来做，可以用People.ResolvePrincipals方法。
  

　　大多数情况下，前面一种Client OM可以满足需要了。
　　
　　不过Web.EnsureUser有个问题就是一次只能添加一个用户，并且这个是一个完整的服务请求，大数据量的情况下效率很成问题。
　　为了解决这个问题，需要利用到多线程。
　　这里我有一段我实际使用的代码作为参考：
　　实际使用多线程的过程中，我遇到了一个问题，参考了这篇讨论中给出的方法：Workaround for the WaitHandle.WaitAll 64 handle limit?
　　 UserInfoList targetList = new UserInfoList(Parameters.TargetUrl, Parameters.ListNames.UserInformation);
　　 IList<User> resolvedUsers = new List<User>();
　　 logger.Info("Sync User Information from {0} to {1} started...", Parameters.SourceUrl, Parameters.TargetUrl);
　　 int threadCount = 0;
　　 ManualResetEvent finished = new ManualResetEvent(false);
　　 foreach (var u in Users)
　　 {
　　 Interlocked.Increment(ref threadCount);
　　 ThreadPool.QueueUserWorkItem(delegate
　　 {
　　 try
　　 {
　　 logger.Info("Resolving user in target web site:", u.SipAddress, u.Account);
　　 if (!String.IsNullOrEmpty(u.Account) && targetList.GetUserInfoByAccount(u.Account) == null)
　　 {
　　 User targetUser = targetList.Web.EnsureUser(u.Account);
　　 targetList.Context.Load(targetUser);
　　 targetList.Context.ExecuteQuery();
　　 resolvedUsers.Add(targetUser);
　　 logger.Info("User resolved:", u.SipAddress, u.Account);
　　 }
　　 else
　　 {
　　 logger.Info("User exists or user is not valid:", u.SipAddress, u.Account);
　　 }
　　 }
　　 catch (Exception)
　　 {
　　 logger.Info("Cannot update user information for {0} ({1})", u.SipAddress, u.Account);
　　 }
　　 finally
　　 {
　　 if (Interlocked.Decrement(ref threadCount) == 0)
　　 {
　　 finished.Set();
　　 }
　　 }
　　 });
　　 }
　　 finished.WaitOne();
　　 logger.Info("Sync User Information from {0} to {1} completed...", Parameters.SourceUrl, Parameters.TargetUrl);
　　
　　
　　如果不熟悉多线程，为了提高性能，只能用传统的Web Service来做，用People.ResolvePrincipals方法，因为这个方法的参数允许数组。在一次HTTP请求中可以传递多个用户，大大节约了HTTP往返时间。
　　同样，我也有一段我实际使用的代码作为参考：
　　值得注意的问题时，使用的时候，不能一次性的添加过多的用户，这样会导致Web Service超时失败。
　　 public UserInfo[] EnsureUsers(string[] accounts, int batch = 200, string url = default(string))
　　 {
　　 if (url == default(string)) { url = WebUrl; }
　　 logger.Info("Ensuring user information in {0} web site", url);
　　 List<PrincipalInfo> pi = new List<PrincipalInfo>();
　　 for (int i = 0; i < Math.Ceiling((double)accounts.Length / batch); i++)
　　 {
　　 string[] batchAccounts = accounts.Skip(i * batch).Take(batch).ToArray();
　　 People peopleService = new People();
　　 peopleService.Url = url + "/_vti_bin/people.asmx";
　　 peopleService.Credentials = System.Net.CredentialCache.DefaultCredentials;
　　 pi.AddRange(peopleService.ResolvePrincipals(batchAccounts, SPPrincipalType.User, true));
　　 }
　　 List<UserInfo> users = Convert(pi);
　　 logger.Info("Found {0} user information items and updated to user information store", users.Count);
　　 return users.ToArray();
　　
　　 }