Интерфейс PermissionObject
Доступ к объектам UserPermissionObject и параметрам разрешений, которые можно применить к форме.
Альтернатива, совместимая с CLS, — .
Пространство имен: Microsoft.Office.Interop.InfoPath.SemiTrust
Сборка: Microsoft.Office.Interop.InfoPath.SemiTrust (в microsoft.office.interop.infopath.semitrust.dll)
Синтаксис
'Декларация
<CLSCompliantAttribute(False)> _
<GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")> _
<CoClassAttribute(GetType(PermissionObjectWrapper))> _
Public Interface PermissionObject
Inherits Permission
'Применение
Dim instance As PermissionObject
[CLSCompliantAttribute(false)]
[GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")]
[CoClassAttribute(typeof(PermissionObjectWrapper))]
public interface PermissionObject : Permission
Заметки
Этот тип является программой-оболочкой для компонентного класса, которого требует управляемый программный код для COM-взаимодействия. Используйте этот тип для доступа к членам интерфейса COM, созданного этим компонентным классом. Дополнительные сведения об интерфейсе COM, включая ссылку на описания его членов, см. в статье Permission.
Чтобы ограничить разрешения на активную форму, а также чтобы возвратить или задать определенные параметры разрешений, используйте класс PermissionObject и его элементы.
Экземпляр класса Permission, связанного с шаблоном формы, возвращен свойством Permission класса _XDocument3.
.gif "Заметка") Заметка |
|---|
Поскольку PermissionObject и его элементы были добавлены в объектную модель Microsoft.Office.Interop.InfoPath.SemiTrust в Microsoft Office InfoPath 2007, необходимо привести объект, возвращенный переменной thisXDocument к типу _XDocument3, чтобы получить доступ к PermissionObject и его элементам. Дополнительные сведения см. в разделе Практическое руководство. Использование элементов Microsoft.Office.Interop.InfoPath.SemiTrust, несовместимых с InfoPath 2003. |
Возвращенный объект PermissionObject предоставляет доступ к объектам UserPermissionObject, связанным с шаблоном формы и со всеми экземплярами форм, созданным с помощью этого шаблона. Каждый объект UserPermissionObject служит для назначения определенного набора прав для того или иного пользователя. Хотя некоторые разрешения, выданные через пользовательский интерфейс, применимы ко всем пользователям, с помощью объекта UserPermissionObject можно назначить разрешения отдельно для каждого пользователя с указанием дат истечения срока действия для каждого из них.
Объект PermissionObject и его свойства и методы доступны в зависимости от наличия ограничений разрешений для активного шаблона формы. Чтобы определить наличие ограничений разрешений для формы, используйте свойство Enabled.
Если клиент управления правами Windows не установлен на пользовательском компьютере, при использовании объекта PermissionObject будет сгенерировано исключение.
Включение разрешений для формы происходит одним из следующих способов с помощью свойств и методов объекта PermissionObject:
Для свойства Enabled задается значение true.
Свойство DocumentAuthor задано.
Свойство RequestPermissionURL задано.
Для свойства StoreLicenses задается значение true или false.
Вызывается метод ApplyPolicy.
Кроме того, включить разрешения для формы можно с помощью метода Add объекта Permission добавлением пользователя в форму.
| Заметка |
|---|
Разрешения нельзя применить, если форма находится в режиме просмотра. По этой причине при предварительном просмотре формы все свойства объекта PermissionObject доступны только для чтения. В режиме просмотра свойство Enabled всегда возвращает значение false, а при попытке кода изменить это значение возникает исключение System.Runtime.InteropServices.COMException и возвращается ошибка "Свойство/метод недоступны в режиме предварительного просмотра". Аналогично, методы, связанные с объектами PermissionObject и UserPermissionObject, также возвратят это сообщение об ошибке, если использовать их в режиме предварительного просмотра. |
См. также
Ссылка
Члены PermissionObject
Пространство имен Microsoft.Office.Interop.InfoPath.SemiTrust