SPRoleCollection.Add method

Artigo
05/12/2015

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 Add criar um objeto de função com a máscara de nome, a descrição e a permissão especificada na coleção 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 Sub Add ( _
    name As String, _
    description As String, _
    permissionMask As SPRights _
)
'Uso
Dim instance As SPRoleCollection
Dim name As String
Dim description As String
Dim permissionMask As SPRights

instance.Add(name, description, permissionMask)

[ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")]
public void Add(
    string name,
    string description,
    SPRights permissionMask
)

Parâmetros

name
Type: System.String

Uma seqüência de caracteres que contém o nome da função.

description
Type: System.String

Uma seqüência de caracteres que contém a descrição da função.

permissionMask
Type: Microsoft.SharePoint.SPRights

Um valor dedeSPRightsdeque especifica os direitos para a máscara de permissões.

Comentários

Para definir uma máscara de permissão para um usuário ou grupo que consiste em vários direitos, use o símbolo de pipe ("|") no Microsoft Visual C# ou Or no Microsoft Visual Basic para delimitar os direitos.

Examples

O exemplo de código a seguir adiciona uma função que tenha permissões para gerenciar o site e seus subsites.

Dim site As SPWeb = 
    SPContext.Current.Site.AllWebs("Site_Name")
Dim roles As SPRoleCollection = site.Roles

roles.Add("Role_Name", "Description", SPRights.ManageWeb _ 
    Or SPRights.ManageSubwebs)

using(SPWeb oWebsite = SPContext.Current.Site.AllWebs["Site_Name"])
{
    SPRoleCollection collRoles = oWebsite.Roles;

    collRoles.Add("Role_Name", "Description", SPRights.ManageWeb | 
        SPRights.ManageSubwebs);
}

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.

Ver também

Referência

SPRoleCollection class

SPRoleCollection members

Microsoft.SharePoint namespace

Compartilhar via