Permission.Add(String, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Cria um novo conjunto de permissões no formulário atual para o usuário especificado com as permissões especificadas e uma data de validade.

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

Parâmetros

bstrUserId

String

O endereço de email no formato user@domain.com do usuário a quem as permissões no formulário atual estão sendo concedidas. Obrigatório.

varPermission

Object

As permissões no formulário atual que estão sendo concedidas ao usuário especificado como uma combinação de um ou mais MsoPermission valores. Opcional.

varExpirationDate

Object

A data de validade das permissões que estão sendo concedidas como um valor System.DateTime . Opcional.

Retornos

UserPermissionObject

Um UserPermissionObject que representa o usuário especificado.

Exemplos

No exemplo a seguir, o método Add é usado para adicionar um novo usuário ao formulário, atribuir esse usuário ao nível de acesso do Controle Completo e definir uma data de validade de dois dias a partir da data atual.

Este exemplo requer uma diretiva de uso ou importações para o namespace Microsoft.Office.Core na seção declarações do módulo de formulário.

_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)

Comentários

Para acessar os MsoPermission valores de enumeração para definir o varPermission parâmetro, você deve definir uma referência à Biblioteca de Objetos do Microsoft Office 14.0 usando a guia COM da caixa de diálogo Adicionar Referência no Visual Studio 2012 ou no Visual Studio. Isso estabelecerá uma referência aos membros do namespace Microsoft.Office.Core .

Como o objeto Permission e seus membros são novos no Microsoft InfoPath, você deve lançar o objeto retornado por essa variávelXDocument para o _XDocument3 tipo para acessar esse objeto e seus membros. Para obter mais informações, consulte Como usar membros do modelo de objeto que não são compatíveis com o InfoPath 2003.

This member can be accessed only by forms opened from a form template that has been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.