Partager via

UserPermissionCollection.Add Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Surcharges

Add(String)

Ajoute un utilisateur dans le formulaire actif.
Add(String, PermissionType)

Ajoute un utilisateur en fonction des autorisations spécifiées.
Add(String, DateTime)

Ajoute un utilisateur dans le formulaire actif en fonction d'une date d'expiration.
Add(String, PermissionType, DateTime)

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.

Add(String)

Ajoute un utilisateur dans le formulaire actif.

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId);
abstract member Add : string -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String) As UserPermission

Paramètres

userId
String

Adresse de messagerie au format user@domain.com de l’utilisateur auquel les autorisations sur le formulaire actuel sont accordées.

Retours

UserPermission

Objet UserPermission qui représente l’utilisateur spécifié.

Exceptions

ArgumentNullException

Le paramètre passé à cette méthode est une référence null (Nothing en 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.

Exemples

Dans l'exemple ci-dessous, le contrôle Bouton permet d'obtenir la collection UserPermissionsCollection pour le formulaire actif et d'ajouter un nouvel utilisateur.

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

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

Remarques

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.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

Add(String, PermissionType)

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

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, Microsoft::Office::InfoPath::PermissionType permission);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, Microsoft.Office.InfoPath.PermissionType permission);
abstract member Add : string * Microsoft.Office.InfoPath.PermissionType -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, permission As PermissionType) As UserPermission

Paramètres

userId
String

Adresse de messagerie au format user@domain.com de l’utilisateur auquel les autorisations sur le formulaire actuel sont accordées.

permission
PermissionType

Autorisations sur le formulaire actuel qui sont accordées à l’utilisateur spécifié sous la forme d’une combinaison d’une ou PermissionType plusieurs valeurs.

Retours

UserPermission

Objet UserPermission.qui représente l’utilisateur spécifié.

Exceptions

ArgumentNullException

Le paramètre passé à cette méthode est une référence null (Nothing en 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.

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

Remarques

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.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

Add(String, DateTime)

Ajoute un utilisateur dans le formulaire actif en fonction d'une date d'expiration.

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, DateTime expirationDate);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, DateTime expirationDate);
abstract member Add : string * DateTime -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, expirationDate As DateTime) As UserPermission

Paramètres

userId
String

Adresse de messagerie au format user@domain.com de l’utilisateur auquel les autorisations sur le formulaire actuel sont accordées.

expirationDate
DateTime

Date d'expiration des autorisations accordées en tant que valeur System.DateTime.

Retours

UserPermission

Objet UserPermission qui représente l’utilisateur spécifié.

Exceptions

ArgumentNullException

Le paramètre passé à cette méthode est une référence null (Nothing en 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.

Exemples

Dans l'exemple ci-dessous, le contrôle Bouton permet d'obtenir la collection UserPermissionsCollection pour le formulaire actif, d'ajouter un utilisateur au formulaire actif, ainsi que de définir une date d'expiration de deux jours à compter de la date du jour.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com",
      dtExpirationDate);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      dtExpirationDate)
End Sub

Remarques

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.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

Add(String, PermissionType, DateTime)

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:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, Microsoft::Office::InfoPath::PermissionType permission, DateTime expirationDate);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, Microsoft.Office.InfoPath.PermissionType permission, DateTime expirationDate);
abstract member Add : string * Microsoft.Office.InfoPath.PermissionType * DateTime -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, permission As PermissionType, expirationDate As DateTime) As UserPermission

Paramètres

userId
String

Adresse de messagerie au format user@domain.com de l’utilisateur auquel les autorisations sur le formulaire actuel sont accordées.

permission
PermissionType

Autorisations sur le formulaire actuel qui sont accordées à l’utilisateur spécifié sous la forme d’une combinaison d’une ou PermissionType plusieurs valeurs.

expirationDate
DateTime

Date d'expiration des autorisations accordées en tant que valeur System.DateTime.

Retours

UserPermission

UserPermission qui représente l’utilisateur spécifié.

Exceptions

FormatException

La valeur DateTime fournie n’est pas valide.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format 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.

Exemples

Dans l’exemple suivant, le fait de cliquer sur le contrôle Button obtient la collection UserPermissionsCollection du formulaire actif, ajoute et affecte un utilisateur au niveau d’accès Contrôle total et définit une date d’expiration de deux jours à partir de la date actuelle.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.FullControl, dtExpirationDate);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.FullControl, dtExpirationDate)
End Sub

Remarques

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.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à