User 類別
代表Microsoft SharePoint Foundation中的使用者。
繼承階層架構
System.Object
Microsoft.SharePoint.Client.ClientObject
Microsoft.SharePoint.Client.Principal
Microsoft.SharePoint.Client.User
命名空間: 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 NotInheritable Class User _
Inherits Principal
'用途
Dim instance As User
public sealed class User : Principal
備註
您可以使用Web類別AllUsers屬性，傳回網站的所有使用者。這包含直接授與權限的使用者，授與使用者群組人員然後瀏覽過網站，並已參照中的人員欄位，例如 [被指派工作給使用者的權限。如果使用者沒有呼叫AllUsers[name]會引發例外狀況。
使用SiteUsers屬性Web類別的網站集合中傳回的所有使用者。
使用Utility類別GetAllAuthenticatedUsers方法傳回所有已驗證的使用者的網站。
使用SPAlertCollection類別GetUniqueUsers方法傳回集合通知的使用者清單。
傳回群組或網站中的使用者，否則使用UsersGroup或Web類別屬性。
使用索引以傳回單一使用者的集合。例如，如果集合被指派到一個名為collUsers變數，使用 C# collUsers[index]或collUsers(index)在 Visual Basic index哪裡編號集合中的使用者，或者是使用者的使用者名稱。
每位使用者具有唯一的成員識別碼 （ID屬性） 具有該成員資格，相關聯的權限，可由SPMember物件。下列範例會將使用者指派給SPMember物件，指定指定的 SharePoint 網站 ︰
Dim oWebsite As SPWeb = SPContext.Current.Web
Dim oMember As SPMember = oWebsite.AllUsers("Domain\\User_Alias")
SPWeb oWebsite = SPContext.Current.Web;
SPMember oMember = oWebsite.AllUsers["Domain\\User_Alias"];
一般使用者與安全性的詳細資訊，請參閱Security, Users, and Groups in Windows SharePoint Services。
範例
本程式碼範例會加入目前的網站上的 [訪客] 群組中的目前的使用者。
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class UserExample
{
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);
}
}
}
執行緒安全
這類型的任何公用 static (共用 於 Visual Basic 中) 成員是安全執行緒。不保證任何執行個體成員都是安全執行緒。