GroupPrincipal.GetMembers Metodo

Origine:

Group.cs

Origine:

Group.cs

Origine:

Group.cs

Origine:

Group.cs

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)

Valori restituiti

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

Commenti

Questo metodo non esegue ricerche ricorsive nel gruppo corrente. Pertanto, gli oggetti gruppo possono essere restituiti nella raccolta di oggetti principale.

I membri vengono restituiti senza rispetto al 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ò contenere anche membri che si trovano in un archivio diverso da quello del gruppo.

Origine:

Group.cs

Origine:

Group.cs

Origine:

Group.cs

Origine:

Group.cs

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

Valori restituiti

Oggetto PrincipalSearchResult<T> che contiene gli oggetti principal membri del gruppo o un insieme vuoto se il gruppo non dispone di 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

La raccolta principale restituita 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 la 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 rispetto al 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ò contenere anche membri che si trovano in un archivio diverso da quello del gruppo.