Clase User
Representa un usuario en Microsoft SharePoint Foundation.
Jerarquía de la herencia
System.Object
Microsoft.SharePoint.Client.ClientObject
Microsoft.SharePoint.Client.Principal
Microsoft.SharePoint.Client.User
Espacio de nombres: Microsoft.SharePoint.Client
Ensamblados: Microsoft.SharePoint.Client.Silverlight (en Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (en Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (en Microsoft.SharePoint.Client.dll)
Sintaxis
'Declaración
Public NotInheritable Class User _
Inherits Principal
'Uso
Dim instance As User
public sealed class User : Principal
Comentarios
Utilice la propiedad AllUsers de la clase Web para devolver todos los usuarios de un sitio. Esto incluye los usuarios concedidos permisos directamente, los usuarios permisos a través de un grupo que, a continuación, visita el sitio y los usuarios que se hace referencia en un campo de la persona, por ejemplo, que se asigna una tarea. Llamar a AllUsers[name] producirá una excepción si el usuario no está allí.
Utilice la propiedad SiteUsers de la clase Web para devolver todos los usuarios de la colección de sitios.
Use el método GetAllAuthenticatedUsers de la clase Utility para devolver todos los usuarios autenticados de un sitio.
Use el método GetUniqueUsers de la clase SPAlertCollection para devolver una lista de usuarios para una colección de alertas.
En caso contrario, utilice la propiedad Users de la clase Group o Web para devolver los usuarios en un grupo o sitio.
Utilice un indizador para devolver un único usuario de la colección. Por ejemplo, si la colección se asigna a una variable denominada collUsers, use collUsers[index] en C# o collUsers(index) en Visual Basic, donde index es el número de índice del usuario de la colección o el nombre de usuario del usuario.
Cada usuario tiene un identificador único miembro (propiedadID ), tiene los permisos asociados con esa pertenencia y se puede representar mediante un objeto SPMember . En el ejemplo siguiente se asigna a un usuario a un objeto SPMember , un sitio SharePoint Web 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 obtener información general acerca de usuarios y seguridad, consulte Security, Users, and Groups in Windows SharePoint Services.
Ejemplos
Este ejemplo de código agrega el usuario actual al grupo de visitantes del sitio actual.
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);
}
}
}
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.