Clase SPUser
Representa un usuario en Microsoft SharePoint Foundation.
Jerarquía de la herencia
System.Object
Microsoft.SharePoint.SPMember
Microsoft.SharePoint.SPPrincipal
Microsoft.SharePoint.SPUser
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public NotInheritable Class SPUser _
Inherits SPPrincipal
'Uso
Dim instance As SPUser
public sealed class SPUser : SPPrincipal
Comentarios
Utilice la propiedad AllUsers de la clase SPWeb para devolver todos los usuarios de un sitio. Esto incluye a los usuarios concedidos permisos directamente, conceder permisos a través de un grupo que, a continuación, se han visitado el sitio y los usuarios que se hace referencia en un campo de persona, por ejemplo, que se va a asignar una tarea a los usuarios. Llamar a AllUsers[name] generará una excepción si el usuario no está allí.
Utilice la propiedad SiteUsers de la clase SPWeb para devolver todos los usuarios de la colección de sitios.
Utilice el método GetAllAuthenticatedUsers de la clase SPUtility para devolver todos los usuarios autenticados de un sitio.
Utilice el método GetUniqueUsers de la clase SPAlertCollection para devolver una lista de usuarios para una colección de alertas.
De lo contrario, utilice la propiedad Users de la clase SPGroup o SPWeb 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 en la colección o el nombre de usuario del usuario.
Cada usuario tiene un identificador de miembro único (propiedadID ), tiene los permisos asociados con esa pertenencia y puede ser representado por un objeto SPMember . En el siguiente ejemplo se asigna a un usuario a un objeto SPMember , proporciona un sitio Web de 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 obtener información general acerca de usuarios y seguridad, vea Security, Users, and Groups in Windows SharePoint Services.
Ejemplos
En el ejemplo de código siguiente se modifica la dirección de correo electrónico, nombre para mostrar y notas para un objeto de usuario especificado.
Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = siteCollection.AllWebs("Site_Name")
Dim user As SPUser = site.AllUsers("User_Name")
user.Email = "E-mail_Address"
user.Name = "Display_Name"
user.Notes = "User_Notes"
user.Update()
SPSite oSiteCollection = SPContext.Current.Site;
using (SPWeb oWebsite = oSiteCollection.AllWebs["Website_Name"])
{
SPUser oUser = oWebsite.AllUsers["User_Name"];
oUser.Email = " E-mail_Address";
oUser.Name = " Display_Name";
oUser.Notes = " User_Notes";
oUser.Update();
}
Nota
Determinados objetos implementan la interfaz de IDisposable y, a continuación, se debe evitar la conservación de estos objetos en la memoria que ya no se necesitan. Para obtener información acerca de buenas prácticas de codificación, vea Disposing Objects.
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.