Permission, classe
Permet d'accéder aux paramètres d'autorisation de UserPermissionCollection pouvant être appliqués à un formulaire.
Hiérarchie d'héritage
System.Object
Microsoft.Office.InfoPath.Permission
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustInherit Class Permission
'Utilisation
Dim instance As Permission
public abstract class Permission
Remarques
Utilisez la classe Permission et ses membres pour restreindre les autorisations au formulaire actif et pour obtenir ou définir des paramètres d'autorisation spécifiques.
Une instance de la classe Permission associée à un modèle de formulaire est renvoyée par la propriété Permission() de la classe XmlForm. L'objet Permission renvoyé permet d'accéder à la collection d'objets UserPermission associés au modèle de formulaire et à chaque instance de formulaire créée avec ce modèle. Chaque objet UserPermission sert à définir un ensemble spécifique de droits pour un utilisateur donné. Certaines autorisations accordées via l'interface utilisateur concernent tous les utilisateurs. Toutefois, vous pouvez utiliser l'objet UserPermission pour les affecter à chaque utilisateur en fonction de dates d'expiration individuelles.
L'objet Permission et ses propriétés et méthodes sont disponibles indépendamment de l'état de restriction des autorisations pour le modèle de formulaire actif. Utilisez la propriété Enabled pour déterminer si un formulaire contient des autorisations restreintes.
Si le client Windows Rights Management n'est pas installé sur l'ordinateur d'un utilisateur, l'utilisation de la classe Permission génère une exception.
Les autorisations d'un formulaire sont activées de l'une des manières suivantes à l'aide des propriétés et méthodes de la classe Permission :
La valeur de la propriété Enabled est définie comme true.
La propriété DocumentAuthor est définie.
La propriété RequestPermissionUrl est définie.
La propriété StoreLicenses est définie sur la valeur true ou false.
La méthode ApplyPolicy est appelée.
Il est également possible d'activer les autorisations d'un formulaire à l'aide d'une méthode Add de la classe UserPermissionCollection afin d'ajouter un utilisateur à la collection des autorisations utilisateur du formulaire.
Notes
Il est impossible d'appliquer des autorisations lorsqu'un formulaire est en mode Aperçu. Par conséquent, toutes les propriétés de la classe Permission sont en lecture seule lors de l'affichage de l'aperçu d'un formulaire. En mode Aperçu, la propriété Enabled renvoie toujours la valeur false et, si du code tente de modifier ce paramètre, un événement System.Runtime.InteropServices.COMException est déclenché et l'erreur « La propriété/méthode n'est pas disponible en mode Aperçu » est générée. De même, les propriétés et méthodes associées aux classes UserPermission et UserPermissionCollection renvoient également ce message d'erreur en mode Aperçu.
Sécurité des threads
Tout membre static (Shared dans Visual Basic) public de ce type garantit la sécurité des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.