Permission.Add(String, Object, Object) Метод

Определение

Пространство имен:

Microsoft.Office.Interop.InfoPath.SemiTrust

Сборка:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

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

public:
 Microsoft::Office::Interop::InfoPath::SemiTrust::UserPermissionObject ^ Add(System::String ^ bstrUserId, System::Object ^ varPermission, System::Object ^ varExpirationDate);

public Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject Add (string bstrUserId, object varPermission, object varExpirationDate);

abstract member Add : string * obj * obj -> Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject

Public Function Add (bstrUserId As String, varPermission As Object, varExpirationDate As Object) As UserPermissionObject

Параметры

bstrUserId

String

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

varPermission

Object

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

varExpirationDate

Object

The expiration date for the permissions that are being granted as a System.DateTime value. Необязательный параметр.

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

UserPermissionObject

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

Примеры

In the following example, the Add method is used to add a new user to the form, assign that user to the Full Control access level, and set an expiration date of two days from the current date.

Для этого пример необходимо использовать директиву 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)

Комментарии

Чтобы получить доступ к MsoPermission значениям перечисления для задания varPermission параметра, необходимо задать ссылку на библиотеку объектов Microsoft Office 14.0 с помощью вкладки COM диалогового окна Добавление ссылки в Visual Studio 2012 или Visual Studio. Это создает ссылку на элемент пространства имен Microsoft.Office.Core.

Так как объект Permission и его члены являются новыми для Microsoft InfoPath, необходимо привести объект, возвращенный переменной thisXDocument , к _XDocument3 типу для доступа к этому объекту и его членам. Дополнительные сведения см. в разделе How to: Use Object Model Members That Are Not Compatible with InfoPath 2003.

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