GroupPrincipal.GetMembers Metoda

Definice

Obor názvů:

System.DirectoryServices.AccountManagement

Sestavení:

System.DirectoryServices.AccountManagement.dll

Balíček:

System.DirectoryServices.AccountManagement v8.0.0

Vrátí kolekci objektů zabezpečení, které jsou obsaženy ve skupině.

Přetížení

GetMembers()	Vrátí kolekci objektů zabezpečení, které jsou obsaženy ve skupině.
GetMembers(Boolean)	Vrátí kolekci objektů zabezpečení, které jsou obsaženy ve skupině. Pokud je rekurzivní příznak nastaven na hodnotu true, tato metoda rekurzivně prohledá aktuální skupinu a vrátí všechny vnořené členy skupiny.

GetMembers()

Zdroj:

Group.cs

Vrátí kolekci objektů zabezpečení, které jsou obsaženy ve skupině.

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)

Návraty

PrincipalSearchResult<Principal>

Objekt PrincipalSearchResult<T> , který obsahuje hlavní objekty, které jsou členy skupiny, nebo prázdnou kolekci, pokud skupina nemá žádné členy.

Poznámky

Tato metoda neprohledává aktuální skupinu rekurzivně. Proto mohou být v kolekci objektů zabezpečení vráceny objekty skupiny.

Členové se vrátí bez ohledu na kontext. Pokud je například kontext služby AD DS založený na "CN=SpecialUsers,DC=Fabrikam,DC=com", sada PrincipalFindResult bude obsahovat také členy skupiny, které se nacházejí v části CN=NormalUsers,DC=Fabrikam,DC=com, i když spadají do rozsahu, který není součástí kontextu, který je prohledán. Vrácená kolekce objektů zabezpečení může také obsahovat členy, které jsou umístěny v jiném úložišti než skupina.

GetMembers(Boolean)

Zdroj:

Group.cs

Vrátí kolekci objektů zabezpečení, které jsou obsaženy ve skupině. Pokud je rekurzivní příznak nastaven na hodnotu true, tato metoda rekurzivně prohledá aktuální skupinu a vrátí všechny vnořené členy skupiny.

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

Logická hodnota, která určuje, zda je skupina prohledána rekurzivně.

Návraty

PrincipalSearchResult<Principal>

Objekt PrincipalSearchResult<T> , který obsahuje hlavní objekty, které jsou členy skupiny, nebo prázdnou kolekci, pokud skupina nemá žádné členy.

Příklady

Následující kód se připojí k doméně LDAP "fabrikam.com" s uživatelským jménem nastaveným na "administrator" a heslem nastaveným na "SecretPwd123" v konstruktoru PrincipalContext .

Vyhledá se skupina s názvem Domain Admins v kontejneru zadaném v konstruktoru PrincipalContext DC=fabrikam,DC=com. Pokud se skupina najde, zobrazí se výčet všech objektů zabezpečení, které jsou členy této skupiny, která zahrnuje rekurzivní členy.

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

Poznámky

Vrácená kolekce objektů zabezpečení neobsahuje objekty skupiny, pokud je rekurzivní příznak nastaven na truehodnotu ; jsou vráceny pouze uzly typu list. Pokud je například rekurzivně prohledána skupina obsahující objekt počítače a objekt skupiny (pouze s objekty zabezpečení uživatele), vrácená kolekce obsahuje objekt počítače a objekty zabezpečení uživatele ve vnořené skupině. Vzhledem k tomu, že objekt skupiny není list, ani když je prázdný, není vrácen v rekurzivním hledání. Pokud je rekurzivní příznak nastavený na false, vrácená kolekce může obsahovat objekty skupiny.

Členové se vrátí bez ohledu na kontext. Pokud je například kontext služby AD DS založený na "CN=SpecialUsers,DC=Fabrikam,DC=com", sada PrincipalFindResult bude obsahovat také členy skupiny, které se nacházejí v části CN=NormalUsers,DC=Fabrikam,DC=com, i když spadají do rozsahu, který není součástí kontextu, který je prohledán. Vrácená kolekce objektů zabezpečení může také obsahovat členy, které jsou umístěny v jiném úložišti než skupina.