Permission.Add - Méthode

Article
05/11/2015

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.

Espace de noms : Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly : Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
Function Add ( _
    bstrUserId As String, _
    varPermission As Object, _
    varExpirationDate As Object _
) As UserPermissionObject
'Utilisation
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)

UserPermissionObject Add(
    string bstrUserId,
    Object varPermission,
    Object varExpirationDate
)

Paramètres

bstrUserId
Type : System.String

L'adresse électronique (au format utilisateur@domaine.com) de l'utilisateur auquel les autorisations sur le formulaire actif sont accordées. Obligatoire.

varPermission
Type : System.Object

Les autorisations sur le formulaire actif accordées à l'utilisateur spécifié, sous forme d'une combinaison d'une ou plusieurs valeurs MsoPermission. Facultatif.

varExpirationDate
Type : System.Object

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

Valeur renvoyée

Type : Microsoft.Office.Interop.InfoPath.SemiTrust.UserPermissionObject
Un objet UserPermissionObject qui représente l'utilisateur spécifié.

Remarques

Pour accéder aux valeurs d’énumération MsoPermission afin de définir le paramètre varPermission, vous devez définir une référence à la bibliothèque d’objets Microsoft Office 14.0 avec 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.

Puisque l’objet Permission et ses membres sont des nouveautés dans Microsoft InfoPath, vous devez envoyer l’objet renvoyé par la variable thisXDocument au type _XDocument3 pour accéder à l’objet et à ses membres. Pour plus d’informations, voir 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.

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)

Voir aussi

Référence

Permission interface

Permission - Membres

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms

Partager via