UserPermissionCollection.Add, méthode (String, PermissionType)

Article
09/24/2014

Ajoute un utilisateur en fonction des autorisations spécifiées.

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

Syntaxe

'Déclaration
Public MustOverride Function Add ( _
    userId As String, _
    permission As PermissionType _
) As UserPermission
'Utilisation
Dim instance As UserPermissionCollection
Dim userId As String
Dim permission As PermissionType
Dim returnValue As UserPermission

returnValue = instance.Add(userId, permission)

public abstract UserPermission Add(
    string userId,
    PermissionType permission
)

Paramètres

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

permission
Type : Microsoft.Office.InfoPath.PermissionType
Autorisations du formulaire actif accordées à l'utilisateur spécifié en tant que combinaison d'une ou plusieurs valeurs PermissionType.

Valeur de retour

Type : Microsoft.Office.InfoPath.UserPermission
Objet UserPermission qui représente l'utilisateur spécifié.

Exceptions

Exception	Condition
ArgumentNullException	Le paramètre passé à cette méthode est une référence NULL (Nothing dans Visual Basic).
ArgumentException	Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect.
SecurityException	Le modèle de formulaire n'est pas configuré avec l'option Autorisation totale de la catégorie Sécurité et approbation dans la boîte de dialogue Options de formulaire.

Remarques

Ce membre est accessible uniquement par les formulaires ouverts à partir d’un modèle de formulaire configuré pour être exécuté avec des autorisations totales à l’aide de la catégorie Sécurité et approbation de la boîte de dialogue Options de formulaire. Ce membre nécessite une autorisation totale pour l’appelant immédiat et ne peut pas être utilisé par un code partiellement fiable. Pour plus d’informations, voir « Using Libraries from Partially Trusted Code » (« Utilisation de bibliothèques à partir de code partiellement fiable ») (éventuellement en anglais) sur MSDN.

Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

Exemples

Dans l'exemple ci-dessous, le contrôle Bouton permet d'obtenir la collection UserPermissionsCollection pour le formulaire actif, ainsi que d'ajouter et d'attribuer un utilisateur au niveau d'accès Contrôle total.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.FullControl);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.FullControl)
End Sub