Share via


SPRoleAssignment class

Define as atribuições de funções para um usuário ou grupo no objeto atual.

Inheritance hierarchy

System.Object
  Microsoft.SharePoint.SPRoleAssignment

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

Syntax

'Declaração
Public NotInheritable Class SPRoleAssignment
'Uso
Dim instance As SPRoleAssignment
public sealed class SPRoleAssignment

Comentários

Para conceder a um usuário ou grupo permissão para conteúdo protegido, você cria um objeto de atribuição de função, definir o usuário ou grupo para a atribuição de função, adicione as definições de funções apropriadas e adicionar o objeto à coleção de atribuições de função de objeto protegível.

Use a propriedade RoleAssignments da interface ISecurableObject , ou da classe SPList, SPListItemou SPWeb , para retornar a coleção de atribuições de função para o objeto fornecido.

Use um indexador para retornar um único item da coleção. Por exemplo, se a coleção for atribuída a uma variável chamada collRoleAssignments, use collRoleAssignments[index] em C# ou deindexde collRoleAssignments() no Visual Basic, onde index é o número de índice do item na coleção ou uma seqüência de caracteres que contém o nome da definição de função.

Examples

O exemplo de código a seguir cria uma nova atribuição de função para um usuário, adiciona uma nova definição de função para as definições de função acoplado para a atribuição de função e em seguida, adiciona a nova atribuição de função para a coleção de atribuições de função para o site.

using(SPWeb oWebsite = SPContext.Current.Site.AllWebs["Subsite_Name"])
{
    SPRoleDefinitionCollection collRoleDefinitions = oWebsite.RoleDefinitions;
    SPRoleAssignmentCollection collRoleAssignments = oWebsite.RoleAssignments;

    SPRoleAssignment oRoleAssignment = new 
SPRoleAssignment("DOMAIN\\User_Alias","User_Alias@Somewhere.com","Displ
ay_Name","Notes");

    SPRoleDefinitionBindingCollection collRoleDefinitionBindings = oRoleAssignment.RoleDefinitionBindings;

    collRoleDefinitionBindings.Add(collRoleDefinitions["Role_Definition_Name"]);

    collRoleAssignments.Add(oRoleAssignment);
}
Using oWebsite As SPWeb = SPContext.Current.Site.AllWebs("Subsite_Name")
    Dim collRoleDefinitions As SPRoleDefinitionCollection = oWebsite.RoleDefinitions
    Dim collRoleAssignments As SPRoleAssignmentCollection = oWebsite.RoleAssignments

    Dim oRoleAssignment As New SPRoleAssignment("DOMAIN\User_Alias","User_Alias@Somewhere.com","Displ ay_Name","Notes")

    Dim collRoleDefinitionBindings As SPRoleDefinitionBindingCollection = oRoleAssignment.RoleDefinitionBindings

    collRoleDefinitionBindings.Add(collRoleDefinitions("Role_Definition_Name"))

    collRoleAssignments.Add(oRoleAssignment)
End Using

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

SPRoleAssignment members

Microsoft.SharePoint namespace