Compartilhar via


SPUser class

Representa um usuário em Microsoft SharePoint Foundation.

Inheritance hierarchy

System.Object
  Microsoft.SharePoint.SPMember
    Microsoft.SharePoint.SPPrincipal
      Microsoft.SharePoint.SPUser

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public NotInheritable Class SPUser _
    Inherits SPPrincipal
'Uso
Dim instance As SPUser
public sealed class SPUser : SPPrincipal

Comentários

Use a propriedade AllUsers da classe SPWeb para retornar todos os usuários de um site. Isso inclui usuários diretamente as permissões, os usuários recebem permissões por meio de um grupo que, em seguida, visitaram o site e os usuários que foram mencionados no campo pessoa, como sendo atribuído a uma tarefa. Chamar AllUsers[name] irá acionar uma exceção se o usuário não estiver lá.

Use a propriedade SiteUsers da classe SPWeb para retornar todos os usuários do conjunto de sites.

Use o método GetAllAuthenticatedUsers da classe SPUtility 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 uma coleção de alertas.

Caso contrário, use a propriedade Users da classe SPGroup ou SPWeb 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 a coleção for atribuída a uma variável chamada collUsers, use collUsers[index] em C# ou deindexde collUsers() 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 identificação de membro exclusivo (propriedadeID ), tem as permissões associadas que a participação e pode ser representado por um objeto SPMember . O exemplo a seguir atribui um usuário a um objeto 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.

Examples

O exemplo de código a seguir modifica o endereço de email, nome de exibição e notas para um objeto de usuário 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();
}

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Thread safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Ver também

Referência

SPUser members

Microsoft.SharePoint namespace