GroupPrincipal.GetMembers Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacchetto:

System.DirectoryServices.AccountManagement v8.0.0

Restituisce un insieme degli oggetti Principal contenuti nel gruppo.

Overload

GetMembers()	Restituisce un insieme degli oggetti Principal contenuti nel gruppo.
GetMembers(Boolean)	Restituisce un insieme degli oggetti Principal contenuti nel gruppo. Quando il flag ricorsivo è impostato a true, questo metodo ricerca in modo ricorsivo il gruppo corrente e restituisce tutti i membri del gruppo annidati.

GetMembers()

Origine:

Group.cs

Restituisce un insieme degli oggetti Principal contenuti nel gruppo.

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)

Restituisce

PrincipalSearchResult<Principal>

Oggetto PrincipalSearchResult<T> che contiene gli oggetti Principal che sono membri del gruppo o un insieme vuoto se il gruppo non contiene membri.

Commenti

Questo metodo non esegue ricerche ricorsive nel gruppo corrente. Pertanto, gli oggetti gruppo possono essere restituiti nell'insieme di oggetti principal.

I membri vengono restituiti senza rispettare il contesto. Ad esempio, se un contesto di Active Directory Domain Services basato su "CN=SpecialUsers,DC=Fabrikam,DC=com", il set PrincipalFindResult includerà i membri del gruppo che si trovano in "CN=NormalUsers,DC=Fabrikam,DC=com", anche se rientrano in un ambito che non fa parte del contesto in cui viene eseguita la ricerca. La raccolta principale restituita può anche contenere membri che si trovano in un archivio diverso da quello del gruppo.

GetMembers(Boolean)

Origine:

Group.cs

Restituisce un insieme degli oggetti Principal contenuti nel gruppo. Quando il flag ricorsivo è impostato a true, questo metodo ricerca in modo ricorsivo il gruppo corrente e restituisce tutti i membri del gruppo annidati.

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)

Parametri

recursive

Boolean

Valore booleano che specifica se la ricerca sul gruppo viene effettuata in modo ricorsivo.

Restituisce

PrincipalSearchResult<Principal>

Oggetto PrincipalSearchResult<T> che contiene gli oggetti Principal che sono membri del gruppo o un insieme vuoto se il gruppo non contiene membri.

Esempio

Il codice seguente si connette al dominio LDAP "fabrikam.com" con il nome utente impostato su "administrator" e la password impostata su "SecretPwd123" nel PrincipalContext costruttore.

Viene eseguita una ricerca per trovare il gruppo con il nome "Domain Admins" nel contenitore specificato nel PrincipalContext costruttore "DC=fabrikam,DC=com". Se il gruppo viene trovato, vengono enumerate tutte le entità che sono membri di questo gruppo, che include membri ricorsivi,

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();   

Commenti

L'insieme principal restituito non contiene oggetti gruppo quando il flag ricorsivo è impostato su true. Vengono restituiti solo i nodi foglia. Ad esempio, quando un gruppo che contiene un oggetto computer e un oggetto gruppo (con solo entità utente) viene eseguita una ricerca in modo ricorsivo, l'insieme restituito contiene l'oggetto computer e gli oggetti entità utente nel gruppo annidato. Poiché l'oggetto gruppo non è una foglia, anche quando è vuoto, non viene restituito nella ricerca ricorsiva. Quando il flag ricorsivo è impostato su false, l'insieme restituito può contenere oggetti gruppo.

I membri vengono restituiti senza rispettare il contesto. Ad esempio, se un contesto di Active Directory Domain Services basato su "CN=SpecialUsers,DC=Fabrikam,DC=com", il set PrincipalFindResult includerà i membri del gruppo che si trovano in "CN=NormalUsers,DC=Fabrikam,DC=com", anche se rientrano in un ambito che non fa parte del contesto in cui viene eseguita la ricerca. La raccolta principale restituita può anche contenere membri che si trovano in un archivio diverso da quello del gruppo.