SharePoint PeopleEditor 控件的使用

最近一段时间，项目用到了PoopleEditor控件，下面的资料都是从网上收集过来并做一些整理 

简单的用法

<%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <%@ Register Tagprefix="Utilities" Namespace="Microsoft.SharePoint.Utilities" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>

<%@ Import Namespace="Microsoft.SharePoint" %>

<SharePoint:PeopleEditor id="PeopleEditor1" runat="server"

    SelectionSet="User"

    ValidatorEnabled="true"

    AllowEmpty = "false"

    MultiSelect = "true"

/>

上面是SharePoint 2007的用法，一般要注册控件
SelectionSet---是可以先择的范围，一般可以是组，人，及Ad的安全组等

ValidatorEnable----如果设置为True，其会自动验证，当刷新的时候

AllowsEmpty--允许为空的意思

获取用户的选择值

 ArrayList list = PeopleEditor1.ResolvedEntities ;

  //获取id和显示名称

foreach (Microsoft.SharePoint.WebControls.PickerEntity p in list)

{

    string userId = p.EntityData["SPUserID"].ToString();

    string DisplayName = p.EntityData["DisplayName"].ToString();               

 }           

//获取帐号

ArrayList selectedAccoutList = PeopleEditor1.Accounts;

 string selectedAccouts2 = PeopleEditor1.CommaSeparatedAccounts;

设置控件的值

PeopleEditor1.CommaSeparatedAccounts = @"JYSERVER\spsadmin,JYSERVER\administrator";

如果是允许多个值，那么可以把放到一个集合里面，如下

string[] user = userPicker.CommaSeparatedAccounts.Split(new string[] { "," }, StringSplitOptions.None)

SharePoint 2010可以引用以下DLL文件

<%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>

--Note：其实在SharePoint 2010 里面可以引用07上段的注册，在开发中一样可以用！

较复杂的用法

下面是一个可以允许组，安全组，人的实例，允许多选！

<SharePoint:PeopleEditor ID="pplApprovers" width="300px" SelectionSet="User,DL,SecGroup,SPGroup" MultiSelect="true" AllowTypeIn="true" IsValid="true" runat="server" />

设置值

private ArrayList approversArray;      

private SPFieldUserValueCollection approversCollection;       

approversCollection = (SPFieldUserValueCollection)item[“Approvers”];       

PickerEntity entity = new PickerEntity();       

approversArray = new ArrayList();       

foreach (SPFieldUserValue spFieldUserValue in approversCollection)       

{       

   entity = new PickerEntity();       

   entity.Key = spFieldUserValue.LookupValue;       

   entity = pplApprovers.ValidateEntity(entity);       

   approversArray.Add(entity);       

}



pplApprovers.UpdateEntities(approversArray);

取值

approversArray = pplApprovers.ResolvedEntities;



//Use the following code to save the data back to the list item:    

approversCollection = new SPFieldUserValueCollection();      

SPUser user;       

SPGroup group;       

foreach (PickerEntity entity in approversArray)       

{       

    if (entity.EntityData["PrincipalType"].ToString() == "SharePointGroup")       

    {       

        group = web.SiteGroups[entity.Key];       

        approversCollection.Add(new SPFieldUserValue(web, group.ID, group.LoginName));       

    }       

    else       

    {       

        //handles SecurityGroup, Distribution List and User       

        user = web.EnsureUser(entity.Key);       

        approversCollection.Add(new SPFieldUserValue(web, user.ID, user.LoginName));       

    }       

}       

item[“Approvers”] = approversCollection;

UI设置方面

一般来说，如果其允许多个选择的时候，其会很比较宽，同时其会比较大，而且选择的按钮也是显示在右下角，当我们用在查询的时候，就会显示得很不好看，所以我们要限制其高度等其他方面让其显示得漂亮一点。下面是我用到的一个可以多重选择的，显示在一行的实例。

                    <td style="width:400px; text-align:left; height:28px; line-height:28px;">

                            <SharePoint:PeopleEditor ID="pdName"  SelectionSet="User,SPGroup" MultiSelect="true"  runat="server" Rows="1" Width="100%" PlaceButtonsUnderEntityEditor="false"

 />

                    </td>

其中

PlaceButtonsUnderEntityEditor="false"  让浏览按钮设置右边
Rows="1" 意思只高度只有一行。

一般来说可以设置其BorderColor="Gray" BorderWidth="1“ 这样子还是挺好看的！

最好设置ValidatorEnabled="true"

上面是我用到查询出报表中，其可以参考上面的复杂用法取值，如我项目中这样做的

            List<string> userlist = new List<string>();

            #region 得到用户列表

            SPWeb web = SPContext.Current.Web;

            ArrayList approversArray = pdName.ResolvedEntities;

            foreach (PickerEntity entity in approversArray)

            {

                if (entity.EntityData["PrincipalType"].ToString() == "SharePointGroup")

                {

                    SPGroup group = web.SiteGroups[entity.Key];

                    grouplist.Add(group);

                }

                else

                {

                    SPUser user = web.EnsureUser(entity.Key);

                    userlist.Add(user.LoginName);

                }

            }

            foreach (SPGroup g in grouplist)

            {

                SPUserCollection users = g.Users;

                foreach (SPUser u in users)

                {

                    if (!userlist.Contains(u.LoginName))

                    {

                        userlist.Add(u.LoginName);

                    }

                }

            }

            #endregion

其他的如Secroup和DL 暂时不知道怎么取，可以较复杂的那种 可以取出来，等用到的时候再填充！

下面是参考的地址：

http://blogs.catapultsystems.com/jdunagan/archive/2011/08/24/sharepointpeopleeditor-basics.aspx

http://www.cnblogs.com/jianyi0115/archive/2007/11/10/955452.html

http://blog.csdn.net/li_shengwangso/article/details/6623479