Метод SPRoleCollection.GetSpecialRole
Примечание. Этот API устарел.
Устаревшие. Вместо этого воспользуйтесь новыми классами, SPRoleDefinition и SPRoleAssignment для определения ролей и назначать их пользователям. Дополнительные сведения содержатся в разделе Changes in the Authorization Object Model. (В Windows SharePoint Services 2.0метода GetCollection возвращается системной роли, задан по типу и сохраняется для обеспечения обратной совместимости.)
Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)
Синтаксис
'Декларация
<ObsoleteAttribute("Use the SPRoleDefinitionCollection class instead")> _
Public Function GetSpecialRole ( _
roleType As SPRoleType _
) As SPRole
'Применение
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
)
Параметры
roleType
Тип: Microsoft.SharePoint.SPRoleTypeSPRoleType значение, которое указывает тип.
Возвращаемое значение
Тип: Microsoft.SharePoint.SPRole
Объект SPRole , который представляет роль.
Примеры
В следующем примере кода метод GetSpecialRole используется для добавления указанного пользователя к роли Reader на текущем сайте.
В этом примере предполагается существование страницы ASPX с элементом управления "Надпись".
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");