Метод SPRoleCollection.Add

Статья
05/13/2015

Примечание. Этот API устарел.

Устаревшие. Вместо этого воспользуйтесь новыми классами, SPRoleDefinition и SPRoleAssignment для определения ролей и назначать их пользователям. Дополнительные сведения содержатся в разделе Changes in the Authorization Object Model. (В Windows SharePoint Services 2.0Add метод создания объекта роли с указанной маской имя, описание и разрешения в коллекции и сохраняется для обеспечения обратной совместимости.)

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

Синтаксис

'Декларация
<ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")> _
Public Sub Add ( _
    name As String, _
    description As String, _
    permissionMask As SPRights _
)
'Применение
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
)

Параметры

name
Тип: System.String

Строка, содержащая имя роли.

description
Тип: System.String

Строка, содержащая описание роли.

permissionMask
Тип: Microsoft.SharePoint.SPRights

ЗначениеSPRights, которое определяет права для маски прав.

Замечания

Чтобы задать маску разрешений для пользователя или группы, которая состоит из нескольких прав, используйте символ вертикальной черты ("|") в Microsoft Visual C# или Or в Microsoft Visual Basic для разделения прав.

Примеры

Следующий пример кода добавляет роль с правами на управление веб-узла и его дочерних сайтах.

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);
}

Примечание

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

См. также

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

SPRoleCollection класс

Элементы SPRoleCollection

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

Поделиться через