Метод Permission.Add

Статья
04/27/2010

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

Этот метод несовместим с CLS.

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

Синтаксис

'Декларация
<DispIdAttribute(2)> _
Function Add ( _
    bstrUserId As String, _
    varPermission As Object, _
    varExpirationDate As Object _
) As UserPermissionObject
'Применение
Dim instance As Permission
Dim bstrUserId As String
Dim varPermission As Object
Dim varExpirationDate As Object
Dim returnValue As UserPermissionObject

returnValue = instance.Add(bstrUserId, varPermission, varExpirationDate)

[DispIdAttribute(2)] 
UserPermissionObject Add (
    string bstrUserId,
    Object varPermission,
    Object varExpirationDate
)

Параметры

bstrUserId
Адрес электронной почты в формате user@domain.com пользователя, которому предоставляются разрешения на работу с текущей формой. Обязательный.

varPermission
Разрешения на работу с текущей формой, предоставляемые определенному пользователю, в виде комбинации одного или нескольких значений MsoPermission. Необязательный.

varExpirationDate
Срок действия для предоставленных разрешений в виде значения System.DateTime. Необязательный.

Возвращаемое значение

UserPermissionObject, представляющий указанного пользователя.

Заметки

Для получения доступа к значениям перечисления MsoPermission для настройки параметра varPermission необходимо задать ссылку на библиотеку объектов Microsoft Office 12.0 с использованием вкладки COM диалогового окна в Набор средств Microsoft Visual Studio для приложений (VSTA) или Visual Studio. Это позволит создать ссылку на элементы пространства имен Microsoft.Office.Core.

Поскольку объект Permission и его элементы впервые появились в Microsoft Office InfoPath 2007, для получения доступа к этому объекту и его элементами необходимо привести объект, возвращенный переменной thisXDocument, к типу _XDocument3. Дополнительные сведения см. в разделе Практическое руководство. Использование элементов Microsoft.Office.Interop.InfoPath.SemiTrust, несовместимых с InfoPath 2003.

Доступ к этому члену имеется только у форм, открытых из шаблона формы, настроенного в разделе "Безопасность и доверие" диалогового окна "Параметры формы" на работу с полным доверием. Этот член требует для текущего вызова полного доверия и не может быть использован программой с частичным доверием. Дополнительные сведения см. в статье "Использование библиотек из программ с частичным доверием" на MSDN.

Пример

В следующем примере метод Add используется для добавления нового пользователя к форме, назначения этому пользователю уровня доступа "Полный доступ" и задания срока действия на два дня, начиная с текущей даты.

Для этого примера необходима директива using или Imports для пространства имен Microsoft.Office.Core в разделе объявлений модуля формы.

_XDocument3 thisDoc = (_XDocument3)thisXDocument;

string strExpirationDate = DateTime.Today.AddDays(2).ToString();
DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

thisDoc.Permission.Add("someone@example.com",
   msoPermission.msoPermissionFullControl, dtExpirationDate);

Dim thisDoc As _XDocument3 = DirectCast(thisXDocument, _XDocument3)

Dim strExpirationDate As String = _
   DateTime.Today.AddDays(2).ToString()
dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

thisDoc.Permission.UserPermissions.Add("someone@example.com", _
   msoPermission.msoPermissionFullControl, dtExpirationDate)

См. также

Ссылка

Интерфейс Permission
Члены Permission
Пространство имен Microsoft.Office.Interop.InfoPath.SemiTrust

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