GroupPrincipal.GetMembers Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

System.DirectoryServices.AccountManagement v8.0.0

Zwraca kolekcję obiektów głównych zawartych w grupie.

Przeciążenia

GetMembers()	Zwraca kolekcję obiektów głównych zawartych w grupie.
GetMembers(Boolean)	Zwraca kolekcję obiektów głównych zawartych w grupie. Gdy flaga rekursywna jest ustawiona na true, ta metoda wyszukuje bieżącą grupę cyklicznie i zwraca wszystkie zagnieżdżone elementy członkowskie grupy.

GetMembers()

Źródło:

Group.cs

Zwraca kolekcję obiektów głównych zawartych w grupie.

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)

Zwraca

PrincipalSearchResult<Principal>

PrincipalSearchResult<T> Obiekt zawierający obiekty główne będące członkami grupy lub pustą kolekcję, jeśli grupa nie ma elementów członkowskich.

Uwagi

Ta metoda nie wyszukuje bieżącej grupy cyklicznie. W związku z tym obiekty grup mogą być zwracane w kolekcji obiektów głównych.

Członkowie są zwracani bez względu na kontekst. Jeśli na przykład kontekst usług AD DS oparty na lokalizacji "CN=SpecialUsers,DC=Fabrikam,DC=com", zestaw PrincipalFindResult będzie zawierać członków grupy znajdujących się w obszarze "CN=NormalUsers,DC=Fabrikam,DC=com", mimo że należą one również do zakresu, który nie jest częścią przeszukanego kontekstu. Zwrócona kolekcja podmiotów zabezpieczeń może również zawierać elementy członkowskie znajdujące się w innym magazynie niż grupa.

GetMembers(Boolean)

Źródło:

Group.cs

Zwraca kolekcję obiektów głównych zawartych w grupie. Gdy flaga rekursywna jest ustawiona na true, ta metoda wyszukuje bieżącą grupę cyklicznie i zwraca wszystkie zagnieżdżone elementy członkowskie grupy.

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)

Parametry

recursive

Boolean

Wartość logiczna określająca, czy grupa jest przeszukiwana cyklicznie.

Zwraca

PrincipalSearchResult<Principal>

PrincipalSearchResult<T> Obiekt zawierający obiekty główne będące członkami grupy lub pustą kolekcję, jeśli grupa nie ma elementów członkowskich.

Przykłady

Poniższy kod łączy się z domeną LDAP "fabrikam.com" z nazwą użytkownika ustawioną na "administrator" i hasłem ustawionym na "SecretPwd123" w konstruktorze PrincipalContext .

Wyszukiwanie jest wykonywane w celu znalezienia grupy o nazwie "Administratorzy domeny" w kontenerze określonym w PrincipalContext konstruktorze "DC=fabrikam,DC=com". Jeśli grupa zostanie znaleziona, zostaną wyliczone wszystkie podmioty zabezpieczeń, które są członkami tej grupy, w tym elementy członkowskie rekursywne.

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

Uwagi

Zwrócona kolekcja podmiotów zabezpieczeń nie zawiera obiektów grupy, gdy flaga cykliczna jest ustawiona na true; zwracane są tylko węzły liścia. Na przykład gdy grupa zawierająca obiekt komputera i obiekt grupy (tylko podmioty zabezpieczeń użytkowników) jest przeszukiwana cyklicznie, zwracana kolekcja zawiera obiekt komputera i obiekty główne użytkownika w zagnieżdżonej grupie. Ponieważ obiekt grupy nie jest liściem, nawet jeśli jest pusty, nie jest zwracany w wyszukiwaniu cyklicznym. Gdy flaga rekursywna jest ustawiona na false, zwracana kolekcja może zawierać obiekty grupy.

Członkowie są zwracani bez względu na kontekst. Jeśli na przykład kontekst usług AD DS oparty na lokalizacji "CN=SpecialUsers,DC=Fabrikam,DC=com", zestaw PrincipalFindResult będzie zawierać członków grupy znajdujących się w obszarze "CN=NormalUsers,DC=Fabrikam,DC=com", mimo że należą one również do zakresu, który nie jest częścią przeszukanego kontekstu. Zwrócona kolekcja podmiotów zabezpieczeń może również zawierać elementy członkowskie znajdujące się w innym magazynie niż grupa.