UserCollection.AddUser 方法
將使用者參數的集合所指定的使用者。
命名空間: Microsoft.SharePoint.Client
組件： Microsoft.SharePoint.Client.Silverlight (在 Microsoft.SharePoint.Client.Silverlight.dll 中); Microsoft.SharePoint.Client.Phone (在 Microsoft.SharePoint.Client.Phone.dll 中) Microsoft.SharePoint.Client (在 Microsoft.SharePoint.Client.dll 中)
語法
'宣告
Public Function AddUser ( _
user As User _
) As User
'用途
Dim instance As UserCollection
Dim user As User
Dim returnValue As User
returnValue = instance.AddUser(user)
public User AddUser(
User user
)
參數
user
類型：Microsoft.SharePoint.Client.User若要新增使用者。
傳回值
類型：Microsoft.SharePoint.Client.User
傳回代表使用者新增User執行個體。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| [Microsoft.SharePoint.SPException] | 使用者不存在，或不是唯一的。錯誤碼 ︰-2130575276。集合是唯讀的。錯誤碼:-1。 |
| [System.Security.SecurityException] | 集合的伺服器陣列管理員群組，而所指定的使用者不是電腦的系統管理員。錯誤碼:-1。 |
| [System.UnauthorizedAccessException] | 目前的使用者會有足夠的權限。錯誤碼 ︰-2147024891。 |
範例
本程式碼範例會加入目前的網站上的 [訪客] 群組中的目前的使用者。
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class UserCollection_AddUserExample
{
static void Main()
{
string siteUrl = "http://MyServer/sites/MySiteCollection";
ClientContext clientContext = new ClientContext(siteUrl);
Web site = clientContext.Web;
GroupCollection collGroup = site.SiteGroups;
// Get the visitors group, assuming its ID is 4.
Group visitorsGroup = collGroup.GetById(4);
User currentUser = site.CurrentUser;
UserCollection collUser = visitorsGroup.Users;
collUser.AddUser(currentUser);
clientContext.Load(currentUser);
clientContext.Load(visitorsGroup);
clientContext.ExecuteQuery();
Console.WriteLine(currentUser.Title + " added to group " + visitorsGroup.Title);
}
}
}