del método SPRoleCollection.GetSpecialRole
NOTA: esta API está ahora obsoleta.
Ha quedado obsoleto. Usar las nuevas clases SPRoleDefinition y SPRoleAssignment en su lugar, para definir las funciones y asignar usuarios a ellos. Para obtener más información, vea Changes in the Authorization Object Model. (En Windows SharePoint Services 2.0, el método GetCollection devuelve una función del sistema especificada por su tipo y se mantiene por compatibilidad con versiones anteriores).
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
<ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")> _
Public Function GetSpecialRole ( _
roleType As SPRoleType _
) As SPRole
'Uso
Dim instance As SPRoleCollection
Dim roleType As SPRoleType
Dim returnValue As SPRole
returnValue = instance.GetSpecialRole(roleType)
[ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")]
public SPRole GetSpecialRole(
SPRoleType roleType
)
Parámetros
roleType
Tipo: Microsoft.SharePoint.SPRoleTypeUn valor de SPRoleType que especifica el tipo.
Valor devuelto
Tipo: Microsoft.SharePoint.SPRole
Objeto SPRole que representa la función.
Ejemplos
En el ejemplo de código siguiente se utiliza el método GetSpecialRole para agregar un usuario especificado a la función Reader en el sitio actual.
En el ejemplo se presupone la existencia de una página .aspx que contiene un control de etiqueta.
Dim site As SPWeb = SPContext.Current.Web
Dim roles As SPRoleCollection = site.Roles
Dim role As SPRole = roles.GetSpecialRole(SPRoleType.Reader)
role.AddUser("User_Name", "E-mail_Address", "User_Display_Name",
"Notes")
SPWeb oWebsite = SPContext.Current.Web;
SPRoleCollection collRoles = oWebsite.Roles;
SPRole oRole = collRoles.GetSpecialRole(SPRoleType.Reader);
oRole.AddUser("User_Name", "E-mail_Address", "User_Display_Name",
"Notes");