SPRoleCollection.GetSpecialRole method
NOTE: This API is now obsolete.
Obsoleto. Use em vez disso, as novas classes SPRoleDefinition e SPRoleAssignment para definir funções e atribuir usuários a elas. Para obter mais informações, consulte Changes in the Authorization Object Model. (Em Windows SharePoint Services 2,0, o método GetCollection retornou uma função de sistema especificada pelo seu tipo e é mantido para compatibilidade com versões anteriores.)
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
<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
Type: Microsoft.SharePoint.SPRoleTypeUm valor de SPRoleType que especifica o tipo.
Valor retornado
Type: Microsoft.SharePoint.SPRole
Um objeto SPRole que representa a função.
Examples
O exemplo de código a seguir usa o método GetSpecialRole para adicionar um usuário especificado para a função Reader no site atual.
O exemplo pressupõe a existência de uma página. aspx que contém um controle label.
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");