SPRoleDefinitionCollection.Add method

Adiciona uma nova definição de função para a coleção.

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

Syntax

'Declaração
Public Sub Add ( _
    role As SPRoleDefinition _
)
'Uso
Dim instance As SPRoleDefinitionCollection
Dim role As SPRoleDefinition

instance.Add(role)

public void Add(
    SPRoleDefinition role
)

Parâmetros

• role
  Type: Microsoft.SharePoint.SPRoleDefinition

  A definição de função a ser adicionado.

Exceptions

Exception	Condition
ArgumentException	A definição de função do site atual não herda do site pai. - ou - O site atual não tem a definição de função exclusiva (a propriedade HasUniqueRoleDefinitions do site atual é false).

Examples

O exemplo de código a seguir cria uma definição de função, define valores de propriedade e adiciona a nova definição de função para a coleção de definições de função para um site da Web.

using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["Subsite_Name"])
{
    SPRoleDefinitionCollection collRoleDefinitions = oWebsite.RoleDefinitions;
    SPRoleDefinition oRoleDefinition = new SPRoleDefinition();
    oRoleDefinition.BasePermissions = SPBasePermissions.AddListItems |
    SPBasePermissions.BrowseDirectories | SPBasePermissions.EditListItems;
    oRoleDefinition.Description = "My custom definition.";
    oRoleDefinition.Name = "Custom Role Definition";
    collRoleDefinitions.Add(oRoleDefinition);
}

Using oWebsite As SPWeb = SPContext.Current.Site.AllWebs("Subsite_Name")
   Dim collRoleDefinitions As SPRoleDefinitionCollection = oWebsite.RoleDefinitions
   Dim oRoleDefinition As New SPRoleDefinition()
   oRoleDefinition.BasePermissions = SPBasePermissions.AddListItems Or SPBasePermissions.BrowseDirectories Or SPBasePermissions.EditListItems
   oRoleDefinition.Description = "My custom definition."
   oRoleDefinition.Name = "Custom Role Definition"
   collRoleDefinitions.Add(oRoleDefinition)
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.

Ver também

Referência

SPRoleDefinitionCollection class

SPRoleDefinitionCollection members

Microsoft.SharePoint namespace