Метод SPGroupCollection.Add

Статья
05/13/2015

Получает значение, которое задает имя шаблона для панели инструментов, используемой для представления списка.

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

Синтаксис

'Декларация
Public Sub Add ( _
    name As String, _
    owner As SPMember, _
    defaultUser As SPUser, _
    description As String _
)
'Применение
Dim instance As SPGroupCollection
Dim name As String
Dim owner As SPMember
Dim defaultUser As SPUser
Dim description As String

instance.Add(name, owner, defaultUser, _
    description)

public void Add(
    string name,
    SPMember owner,
    SPUser defaultUser,
    string description
)

Параметры

name
Тип: System.String

Строка, представляющая имя новой группы.

owner
Тип: Microsoft.SharePoint.SPMember

Объект SPMember , определяющий владельца.

defaultUser
Тип: Microsoft.SharePoint.SPUser

Объект SPUser , определяющий пользователя по умолчанию для группы.

description
Тип: System.String

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

Исключения

Исключение	Условие
ArgumentException	owner — null .
SPException	Коллекции группы только для чтения. -или- Владельцем является группа ролей или домена. -или- Группа не уровне веб-узла группы.

ArgumentException

owner — null .

SPException

Коллекции группы только для чтения.

-или-

Владельцем является группа ролей или домена.

-или-

Группа не уровне веб-узла группы.

Примеры

Следующий пример кода создает группу в текущем семействе узлов.

Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Try
    Dim groups As SPGroupCollection = webSite.SiteGroups
    Dim user As SPUser = webSite.Users("User_Name")
    Dim member As SPMember = webSite.Users("User_Name")

    groups.Add("Group_Name", member, user, "Description")
Finally
    webSite.Dispose()
End Try

using (SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb)
{
    SPGroupCollection collGroups = oWebsiteRoot.SiteGroups;
    SPUser oUser = oWebsiteRoot.Users["User_Name"];
    SPMember oMember = oWebsiteRoot.Users["User_Name"];

    collGroups.Add("Group_Name", oMember, oUser, "Description");
}

Примечание

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

См. также

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

SPGroupCollection класс

Элементы SPGroupCollection

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

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