Clase SPRoleAssignment
Define las asignaciones de funciones para un usuario o grupo en el objeto actual.
Jerarquía de la herencia
System.Object
Microsoft.SharePoint.SPRoleAssignment
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Public NotInheritable Class SPRoleAssignment
'Uso
Dim instance As SPRoleAssignment
public sealed class SPRoleAssignment
Comentarios
Para conceder a un usuario o grupo permiso para contenido asegurable, se crea un objeto de asignación de roles, establecer el usuario o de grupo para la asignación de roles, agregue las definiciones de roles adecuados y agrega el objeto a la colección de asignaciones de funciones para el objeto protegible.
Utilice la propiedad RoleAssignments de la interfaz de ISecurableObject o de la clase SPList, SPListItemo SPWeb , para devolver la colección de asignaciones de funciones para el objeto dado.
Utilice un indizador para devolver un único elemento de la colección. Por ejemplo, si la colección se asigna a una variable denominada collRoleAssignments, use collRoleAssignments[index] en C# o collRoleAssignments(index) en Visual Basic, donde index es el número de índice del elemento de la colección o una cadena que contiene el nombre de la definición de roles.
Ejemplos
En el ejemplo de código siguiente se crea una nueva asignación de funciones para un usuario, se agrega una nueva definición de rol para las definiciones de roles enlazadas para la asignación de roles y, a continuación, agrega la nueva asignación de roles a la colección de asignaciones de funciones para el sitio Web.
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
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.