Permission Classe

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Fournit l’accès aux paramètres d’autorisation UserPermissionCollection et qui peuvent être appliqués à un formulaire.

public ref class Permission abstract

public abstract class Permission

type Permission = class

Public MustInherit Class Permission

Héritage

Object

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 retournée par la Microsoft.Office.InfoPath.Xmlform.Permission propriété de la XmlForm classe . L’objet Permission renvoyé donne accès à la collection d’objets UserPermission associée au modèle de formulaire et à chaque formulaire instance créé avec ce modèle. Chaque objet UserPermission est utilisé pour définir un ensemble spécifique de droits pour un utilisateur individuel. Bien que certaines autorisations accordées via l’interface utilisateur s’appliquent à tous les utilisateurs, vous pouvez utiliser l’objet UserPermission pour attribuer des autorisations par utilisateur avec des dates d’expiration par utilisateur.

L'objet Permission, ses propriétés et ses méthodes sont accessibles indépendamment des restrictions d'autorisations appliquées au modèle de formulaire actif. Utilisez la Enabled propriété pour déterminer si un formulaire dispose d’autorisations restreintes.

[!REMARQUE] 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 sur un formulaire sont activées de l’une des manières suivantes à l’aide des propriétés et des méthodes de la classe Permission :

La propriété Enabled est définie sur la valeur true.

La DocumentAuthor propriété est définie.

La RequestPermissionUrl propriété est définie.

La StoreLicenses propriété a la valeur true ou false.

La ApplyPolicy(String) méthode est appelée.

Les autorisations sur un formulaire peuvent également être activées à l’aide de l’une Add(String) des méthodes de la classe UserPermissionCollection pour ajouter un utilisateur à la collection d’autorisations utilisateur du formulaire.

Remarque : Les autorisations ne peuvent pas être appliquées lorsqu’un formulaire est en mode d’aperçu. Ainsi, toutes les propriétés de la classe Permission sont en lecture seule dans l'aperçu du formulaire. En mode Aperçu, la propriété Enabled retourne toujours la valeur false et, si le code essaie de modifier ce paramètre, une exception System.Runtime.InteropServices.COMException est générée et l'erreur « La propriété/méthode n'est pas disponible en mode Aperçu » est retourné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.

Constructeurs

Permission()

Fournit l’accès aux paramètres d’autorisation UserPermissionCollection et qui peuvent être appliqués à un formulaire.

Propriétés

DocumentAuthor	Obtient ou définit l'auteur du formulaire actif sous forme d'adresse électronique.
Enabled	Obtient ou définit l'information indiquant que les paramètres d'autorisation représentés par l'objet Permission sont activés pour le formulaire actif.
PermissionFromPolicy	Indique si une stratégie d'autorisation a été appliquée au formulaire actif.
PolicyDescription	Obtient une description de la stratégie appliquée au formulaire actif.
PolicyName	Obtient le nom de la stratégie appliquée au formulaire actif.
RequestPermissionUrl	Obtient ou définit le fichier, l'URL ou l'adresse électronique que les utilisateurs doivent utiliser s'ils ont besoin d'autorisations supplémentaires sur le formulaire actif.
StoreLicenses	Obtient ou définit l'information indiquant que la licence permettant à l'utilisateur d'afficher le formulaire actif doit être mise en cache pour permettre son affichage en mode hors connexion lorsque l'utilisateur ne peut pas se connecter à un serveur de gestion des droits.
UserPermissions	Obtient un UserPermissionCollection pour le formulaire actif.

Méthodes

ApplyPolicy(String)

Applique une stratégie au formulaire en utilisant un fichier de modèle de stratégie.