Описание
Создает новый объект Group (только в рабочей области ядра Microsoft Jet).
Set группа = объект.CreateGroup (имя, код)
Параметры
группа
Объектная переменная, задающая создаваемый объект Group.
объект
Объектная переменная, задающая объект User или Workspace, в котором создается новый объект Group.
имя
Необязательный. Выражение или переменная типа Variant (подтип String),содержащая уникальное имя нового объекта Group. Сведения о допустимых именах групп приведены в разделе о свойстве Name.
код
Необязательный. Выражение или переменная типа Variant (подтип String), содержащая код учетной записи группы. Код учетной записи группы должен содержать от 4 до 20 букв или цифр. Сведения о допустимых значениях кода учетной записи приведены в разделе о свойстве PID (код учетной записи).
Замечания
Метод CreateGroup используется для создания нового объекта Group в объекте User или Workspace. Если опустить какие-либо элементы синтаксиса при вызове метода CreateGroup, то можно задать или изменить значения соответствующего свойства с помощью инструкции присваивания перед добавлением нового объекта в семейство. После добавления нового объекта в семейство допускается изменение значений некоторых (но не всех) свойств группы. Дополнительные сведения приведены в разделах, посвященных отдельным свойствам.
Если аргумент имя указывает на объект, который уже добавлен в семейство, то при вызове метода Append возникает ошибка выполнения.
Для удаления объекта Group из семейства Groups следует применить к семейству метод Delete.
Пример
Следующая программа использует метод CreateGroup для создания нового объекта Group; затем делает пользователя "admin" членом нового объекта Group и печатает списки свойств и пользователей.
Sub CreateGroupX() Dim wrkDefault As Workspace Dim grpNew As Group Dim grpTemp As Group Dim prpLoop As Property Dim usrLoop As User Set wrkDefault = DBEngine.Workspaces(0) With wrkDefault ' Создает и добавляет новую группу. Set grpNew = .CreateGroup("НоваяГруппа", "AAA123456789") .Groups.Append grpNew ' Делает пользователя "admin" членом группы ' "НоваяГруппа", создавая и добавляя объект ' Group в семейство Groups пользователей. Set grpTemp = .Users("admin").CreateGroup("НоваяГруппа") .Users("admin").Groups.Append grpTemp Debug.Print "Свойства " & grpNew.Name ' Отображает семейство Properties объекта НоваяГруппа. ' Свойство PID недоступно для чтения. For Each prpLoop In grpNew.Properties On Error Resume Next If prpLoop <> "" Then Debug.Print " " & prpLoop.Name & " = " & prpLoop On Error GoTo 0 Next prpLoop Debug.Print "Семейство Users объекта " & grpNew.Name ' Печатает семейство Users объекта "НоваяГруппа". For Each usrLoop In grpNew.Users Debug.Print " " & usrLoop.Name Next usrLoop ' Удаляет новый объект Group, созданный ' только для демонстрации. .Groups.Delete "НоваяГруппа" End With End Sub