Класс Permission

Статья
04/27/2010

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

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
Public MustInherit Class Permission
'Применение
Dim instance As Permission

public abstract class Permission

Заметки

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

Экземпляр класса Permission, связанной с шаблоном формы, возвращается свойством Permission класса XmlForm. Возвращенный объект Permission предоставляет доступ к коллекции объектов UserPermission, связанных с шаблоном формы и каждым экземпляром формы, созданным с помощью этого шаблона. Каждый объект UserPermission используется для определения отдельного набора прав для отдельного пользователя. В то время как разрешения, предоставленные через пользовательский интерфейс, применяются ко всем пользователям, чтобы назначить разрешение отдельному пользователю с индивидуальным сроком действия, можно использовать объект UserPermission.

Объект Permission и его свойства и методы доступны независимо от того, применяются ограниченные разрешения к активному шаблону формы или нет. Используйте свойство Enabled, чтобы определить, имеет ли форма ограниченные разрешения.

Если на компьютере пользователя не установлен клиент службы управления правами Windows, использование класса Permission вызовет исключение.

Разрешения для формы включаются одним из следующих способов с помощью свойств и методов класса Permission:

Для свойства Enabled устанавливается значение true.

Устанавливается свойство DocumentAuthor.

Устанавливается свойство RequestPermissionUrl.

Для свойства StoreLicenses устанавливается значение true или false.

Вызывается метод ApplyPolicy.

Разрешения для формы также можно включить с помощью одного из методов Add класса UserPermissionCollection, чтобы добавить пользователя к набору разрешений пользователей формы.

Заметка
Разрешения нельзя применить к форме в режиме предварительного просмотра. Поэтому все свойства класса Permission доступны только для чтения, когда форма находится в режиме предварительного просмотра. В этом режиме свойство Enabled всегда возвращает значение false, и если код пытается изменить этот параметр, вызывается исключение System.Runtime.InteropServices.COMException и возвращается ошибка "Свойство/метод недоступны в режиме предварительного просмотра". Подобным образом, свойства и методы, связанные с классами UserPermission и UserPermissionCollection, также возвращают это сообщение об ошибке, когда используются в режиме предварительного просмотра.

Разрешения нельзя применить к форме в режиме предварительного просмотра. Поэтому все свойства класса Permission доступны только для чтения, когда форма находится в режиме предварительного просмотра. В этом режиме свойство Enabled всегда возвращает значение false, и если код пытается изменить этот параметр, вызывается исключение System.Runtime.InteropServices.COMException и возвращается ошибка "Свойство/метод недоступны в режиме предварительного просмотра". Подобным образом, свойства и методы, связанные с классами UserPermission и UserPermissionCollection, также возвращают это сообщение об ошибке, когда используются в режиме предварительного просмотра.

Иерархия наследования

System.Object
Microsoft.Office.InfoPath.Permission

Безопасность потока

Все открытые статические (Общие в Visual Basic) члены этого типа потокобезопасны. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылка

Члены Permission
Пространство имен Microsoft.Office.InfoPath

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