User classe
Representa um usuário no Microsoft SharePoint Foundation.
Inheritance hierarchy
System.Object
Microsoft.SharePoint.Client.ClientObject
Microsoft.SharePoint.Client.Principal
Microsoft.SharePoint.Client.User
Namespace: Microsoft.SharePoint.Client
Assemblies: Microsoft.SharePoint.Client.Silverlight (em Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (em Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)
Sintaxe
'Declaração
Public NotInheritable Class User _
Inherits Principal
'Uso
Dim instance As User
public sealed class User : Principal
Comentários
Use a propriedade AllUsers da classe Web para retornar todos os usuários de um site. Isso inclui usuários a concessão de permissões diretamente, conceder permissões de usuários por meio de um grupo que então visitou o site e os usuários que foram referenciados em um campo de pessoa, como sendo de uma tarefa atribuída. Chamar AllUsers[name] irá acionar uma exceção se o usuário não estiver lá.
Use a propriedade SiteUsers da classe Web para retornar todos os usuários no conjunto de sites.
Use o método GetAllAuthenticatedUsers da classe Utility para retornar todos os usuários autenticados de um site.
Use o método GetUniqueUsers da classe SPAlertCollection para retornar uma lista de usuários para um conjunto de alertas.
Caso contrário, use a propriedade Users da classe Group ou Web para retornar os usuários em um grupo ou site.
Use um indexador para retornar um único usuário da coleção. Por exemplo, se o conjunto é atribuído a uma variável chamada collUsers, use collUsers[index] em c# ou collUsers(index) no Visual Basic, onde index é o número de índice do usuário na coleção ou o nome de usuário do usuário.
Cada usuário tem uma ID de membro exclusivo (ID propriedade), tem as permissões associadas a esse associação e pode ser representado por um objeto SPMember . O exemplo a seguir atribui um usuário a um objeto de SPMember , dado um site do SharePoint especificado:
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"];
Para obter informações gerais sobre segurança e usuários, consulte Security, Users, and Groups in Windows SharePoint Services.
Exemplos
Este exemplo de código adiciona o usuário atual ao grupo de visitantes do site atual.
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);
}
}
}
Segurança de thread
Os membros públicos estática (Shared no Visual Basic) desse tipo são seguros para thread. Nenhum membro de instância pode ser garantido como seguro para thread.