Метод SPRoleDefinitionCollection.Add

Добавляет в коллекцию новое определение роли.

Пространство имен:  Microsoft.SharePoint
Сборка:  Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Sub Add ( _
    role As SPRoleDefinition _
)
'Применение
Dim instance As SPRoleDefinitionCollection
Dim role As SPRoleDefinition

instance.Add(role)

public void Add(
    SPRoleDefinition role
)

Параметры

• role
  Тип: Microsoft.SharePoint.SPRoleDefinition

  Определение роли для добавления.

Исключения

Исключение	Условие
ArgumentException	Определение роли текущего веб-сайта не наследуется от родительского веб-сайта. -или- Текущий веб-узел не имеет уникальное определение (свойство HasUniqueRoleDefinitions для текущего веб-сайта — false).

Примеры

В следующем примере кода создается определение роли, задает значения свойств и добавляет новое определение роли в коллекцию определений ролей для веб-узла.

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

Примечание

Некоторые объекты реализуют интерфейс IDisposable и следует избегать сохранения этих объектов в памяти, после они больше не нужны. Disposing Objectsсведения о рекомендованные методы программирования, см.

См. также

Справочные материалы

SPRoleDefinitionCollection класс

Элементы SPRoleDefinitionCollection

Пространство имен Microsoft.SharePoint