GroupPrincipal.GetMembers Méthode

Définition

Espace de noms:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paquet:

System.DirectoryServices.AccountManagement v8.0.0

Retourne une collection des objets Principal qui est contenue dans le groupe.

Surcharges

GetMembers()	Retourne une collection des objets Principal qui est contenue dans le groupe.
GetMembers(Boolean)	Retourne une collection des objets Principal qui est contenue dans le groupe. Lorsque l'indicateur recursive a la valeur true, cette méthode effectue une recherche dans le groupe actuel de manière récursive et retourne tous les membres de groupe imbriqués.

GetMembers()

Source:

Group.cs

Retourne une collection des objets Principal qui est contenue dans le groupe.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetMembers();

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetMembers ();

member this.GetMembers : unit -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetMembers () As PrincipalSearchResult(Of Principal)

Retours

PrincipalSearchResult<Principal>

Objet PrincipalSearchResult<T> qui contient les objets Principal qui sont membres du groupe ou une collection vide si le groupe n'a pas de membres.

Remarques

Cette méthode ne recherche pas le groupe actuel de manière récursive. Par conséquent, les objets group peuvent être retournés dans la collection d’objets principal.

Les membres sont retournés sans respecter le contexte. Par exemple, si un contexte AD DS basé sur « CN=SpecialUsers,DC=Fabrikam,DC=com », le jeu PrincipalFindResult inclut également des membres de groupe situés sous « CN=NormalUsers,DC=Fabrikam,DC=com », même s’ils appartiennent à une étendue qui ne fait pas partie du contexte recherché. La collection de principaux retournée peut également contenir des membres situés dans un magasin différent du groupe.

GetMembers(Boolean)

Source:

Group.cs

Retourne une collection des objets Principal qui est contenue dans le groupe. Lorsque l'indicateur recursive a la valeur true, cette méthode effectue une recherche dans le groupe actuel de manière récursive et retourne tous les membres de groupe imbriqués.

public:
 System::DirectoryServices::AccountManagement::PrincipalSearchResult<System::DirectoryServices::AccountManagement::Principal ^> ^ GetMembers(bool recursive);

public System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal> GetMembers (bool recursive);

member this.GetMembers : bool -> System.DirectoryServices.AccountManagement.PrincipalSearchResult<System.DirectoryServices.AccountManagement.Principal>

Public Function GetMembers (recursive As Boolean) As PrincipalSearchResult(Of Principal)

Paramètres

recursive

Boolean

Valeur de type booléen spécifiant si la recherche dans le groupe doit être effectuée de manière récursive.

Retours

PrincipalSearchResult<Principal>

Objet PrincipalSearchResult<T> qui contient les objets Principal qui sont membres du groupe ou une collection vide si le groupe n'a pas de membres.

Exemples

Le code suivant se connecte au domaine LDAP « fabrikam.com » avec le nom d’utilisateur défini sur « administrateur » et le mot de passe défini sur « SecretPwd123 » dans le PrincipalContext constructeur.

Une recherche est effectuée pour rechercher le groupe qui porte le nom « Administrateurs de domaine » sous le conteneur spécifié dans le PrincipalContext constructeur « DC=fabrikam,DC=com ». Si le groupe est trouvé, tous les principaux membres de ce groupe, qui inclut les membres récursifs, sont ensuite énumérés

PrincipalContext ctx = new PrincipalContext(ContextType.Domain,                                                                      
                                            "fabrikam.com",   
                                            "DC=fabrikam,DC=com",   
                                            "administrator",   
                                            "SecretPwd123");  

GroupPrincipal grp = GroupPrincipal.FindByIdentity(ctx,   
                                                   IdentityType.Name,   
                                                   "Domain Admins");  

if (grp != null)  
{  
    foreach (Principal p in grp.GetMembers(true))  
    {  
         Console.WriteLine(p.Name);  
    }  
    grp.Dispose();  
}  

ctx.Dispose();   

Remarques

La collection de principaux retournée ne contient pas d’objets de groupe lorsque l’indicateur récursif est défini sur true; seuls les nœuds feuilles sont retournés. Par exemple, lorsqu’un groupe qui contient un objet ordinateur et un objet groupe (avec uniquement des principaux d’utilisateur) fait l’objet d’une recherche récursive, la collection retournée contient l’objet ordinateur et les objets utilisateur principal dans le groupe imbriqué. Étant donné que l’objet de groupe n’est pas une feuille, même s’il est vide, il n’est pas retourné dans la recherche récursive. Lorsque l’indicateur récursif a la falsevaleur , la collection retournée peut contenir des objets group.

Les membres sont retournés sans respecter le contexte. Par exemple, si un contexte AD DS basé sur « CN=SpecialUsers,DC=Fabrikam,DC=com », le jeu PrincipalFindResult inclut également des membres de groupe situés sous « CN=NormalUsers,DC=Fabrikam,DC=com », même s’ils appartiennent à une étendue qui ne fait pas partie du contexte recherché. La collection de principaux retournée peut également contenir des membres situés dans un magasin différent du groupe.