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

Définition

Espace de noms:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Crée un nouvel ensemble d'autorisations sur le formulaire actif pour l'utilisateur spécifié, comprenant les autorisations indiquées et une date d'expiration.

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

Paramètres

bstrUserId

String

Adresse de messagerie au format user@domain.com de l’utilisateur auquel les autorisations sur le formulaire actuel sont accordées. Obligatoire.

varPermission

Object

Autorisations sur le formulaire actuel qui sont accordées à l’utilisateur spécifié sous la forme d’une combinaison d’une ou MsoPermission plusieurs valeurs. Optional.

varExpirationDate

Object

La date d'expiration des autorisations accordées, sous forme de valeur System.DateTime. Optional.

Retours

UserPermissionObject

UserPermissionObject qui représente l’utilisateur spécifié.

Exemples

Dans l'exemple suivant, la méthode Add sert à ajouter un nouvel utilisateur au formulaire, à accorder à cet utilisateur un niveau d'accès Contrôle total et à définir une date d'expiration deux jours après la date actuelle.

Cet exemple a besoin d'une directive using ou Imports pour l'espace de noms Microsoft.Office.Core dans la section des déclarations du module du formulaire.

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

Remarques

Pour accéder aux MsoPermission valeurs d’énumération permettant de définir le varPermission paramètre, vous devez définir une référence à la bibliothèque d’objets Microsoft Office 14.0 à l’aide de l’onglet COM de la boîte de dialogue Ajouter une référence dans Visual Studio 2012 ou Visual Studio. Cela établit une référence aux membres de l’espace de noms Microsoft.Office.Core.

Étant donné que l’objet Permission et ses membres sont nouveaux dans Microsoft InfoPath, vous devez convertir l’objet retourné par la variable thisXDocument en _XDocument3 type pour accéder à cet objet et à ses membres. Pour plus d'informations, consultez Procédure : utiliser les membres du modèle objet qui ne sont pas compatibles avec InfoPath 2003.

Seuls les formulaires ouverts à partir d’un modèle de formulaire qui ont été configurés pour s’exécuter en mode confiance totale en utilisant la catégorie Sécurité et approbation de la boîte de dialogue Options de formulaire peuvent accéder à ce membre. Ce membre nécessite la confiance totale pour l’appelant immédiat et ne peut être utilisé par un code ayant un niveau de confiance partiel. Pour plus d’informations, voir « Utilisation de bibliothèques à partir de code d’un niveau de confiance partiel » sur MSDN.