Permission.Add(String, Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 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.