User.IsUserMemberOf(String) Méthode

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Détermine si l'utilisateur actuel est membre du groupe spécifié.

public:
 abstract bool IsUserMemberOf(System::String ^ groupName);

public abstract bool IsUserMemberOf (string groupName);

abstract member IsUserMemberOf : string -> bool

Public MustOverride Function IsUserMemberOf (groupName As String) As Boolean

Paramètres

groupName

String

Nom du groupe au format domaine\nom_groupe.

Retours

Boolean

La valeur true est renvoyée si l'utilisateur actuel est membre du groupe spécifié. Dans le cas contraire, c'est la valeur false qui est renvoyée.

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.

Exemples

Dans l'exemple suivant, un clic sur le contrôle Bouton permet de déterminer si l'utilisateur actuel est membre du groupe spécifié.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   MessageBox.Show(
      this.Application.User.IsUserMemberOf(
      "CONTOSO\\Users").ToString());
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   MessageBox.Show( _
      Me.Application.User.IsUserMemberOf("CONTOSO\\Users").ToString())
End Sub

Remarques

Même si la IsUserMemberOf(String) méthode est marquée comme niveau de sécurité 2, elle n’est pas toujours accessible. Lorsqu’un appel à la IsUserMemberOf(String) méthode est effectué, InfoPath effectue d’abord une case activée de sécurité pour déterminer si l’accès à cette méthode est autorisé. Cette vérification de la sécurité permet de confirmer la fiabilité du code appelant et de déterminer son emplacement.

Si le code appelant est approuvé (comme c’est le cas lorsque, par exemple, la IsUserMemberOf(String) méthode est appelée à partir d’un modèle de formulaire InfoPath installé ou signé, ou à partir d’un code externe approuvé, tel qu’un fichier exécutable sur l’ordinateur local), InfoPath autorise l’accès complet à la IsUserMemberOf(String) méthode.

Si le code appelant n'est pas fiable, par exemple si l'appel émane d'un modèle de formulaire InfoPath basé sur un domaine, InfoPath vérifie au préalable l'origine de l'appel. Si l’appel provient d’un code qui n’est pas approuvé dans un modèle de formulaire InfoPath à une URL telle que «http://www.contoso.com/example.xsn », l’appel provient de la zone Internet. InfoPath refuse l’accès à la IsUserMemberOf(String) méthode pour tous les appels qui ne sont pas approuvés provenant de la zone Internet. Si l’appel provient d’une URL telle que «http://contoso/example.xsn », l’appel provient de la zone Intranet. Lorsqu'un appel non approuvé émane de la zone intranet, InfoPath vérifie si les paramètres d'authentification de l'utilisateur d'Internet Explorer autorisent l'ouverture de session automatique (dans la zone intranet uniquement ou pour toutes les ouvertures de session). Si Internet Explorer est configuré pour une ouverture de session automatique, InfoPath vérifie l'appartenance de l'utilisateur au groupe. Si l’appartenance au groupe est publique, InfoPath autorise un accès complet à la IsUserMemberOf(String) méthode. Si l'appartenance au groupe n'est pas entièrement publique, InfoPath masque le résultat. En d'autres termes, InfoPath traite l'appartenance à un groupe comme si elle n'était pas visible. Dans ce cas, la valeur de retour est toujours false , car l’appartenance au groupe n’est pas publique. InfoPath ne signale pas que l'accès est refusé.

Remarque : les informations d’appartenance au groupe sont entièrement publiques si l’accès à ces informations est autorisé et qu’elles sont visibles par tous les utilisateurs non anonymes. Si un seul utilisateur non anonyme se voit refuser l'accès aux informations d'appartenance à un groupe, ces informations ne sont pas considérées comme entièrement publiques.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

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