GroupPrincipal.GetMembers Yöntem

Tanım

Ad Alanı:

System.DirectoryServices.AccountManagement

Bütünleştirilmiş Kod:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Grupta yer alan asıl nesnelerin koleksiyonunu döndürür.

Aşırı Yüklemeler

GetMembers()	Grupta yer alan asıl nesnelerin koleksiyonunu döndürür.
GetMembers(Boolean)	Grupta yer alan asıl nesnelerin koleksiyonunu döndürür. Özyinelemeli bayrağı true olarak ayarlandığında, bu yöntem geçerli grupta özyinelemeli olarak arama yapıp tüm iç içe grup üyelerini döndürür.

GetMembers()

Kaynak:

Group.cs

Grupta yer alan asıl nesnelerin koleksiyonunu döndürür.

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)

Döndürülenler

PrincipalSearchResult<Principal>

PrincipalSearchResult<T> Grubun üyesi olan asıl nesneleri içeren bir nesne veya grubun üyesi yoksa boş bir koleksiyon.

Açıklamalar

Bu yöntem geçerli grupta özyinelemeli olarak arama yapmaz. Bu nedenle, grup nesneleri asıl nesne koleksiyonunda döndürülebilir.

Üyeler bağlama göre döndürülür. Örneğin, "CN=SpecialUsers,DC=Fabrikam,DC=com" temelinde bir AD DS bağlamı varsa PrincipalFindResult kümesi, aranan bağlamın parçası olmayan bir kapsamın altında olsalar bile "CN=NormalUsers,DC=Fabrikam,DC=com" altında bulunan grup üyelerini de içerir. Döndürülen sorumlu koleksiyonu, gruptan farklı bir depoda bulunan üyeleri de içerebilir.

GetMembers(Boolean)

Kaynak:

Group.cs

Grupta yer alan asıl nesnelerin koleksiyonunu döndürür. Özyinelemeli bayrağı true olarak ayarlandığında, bu yöntem geçerli grupta özyinelemeli olarak arama yapıp tüm iç içe grup üyelerini döndürür.

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)

Parametreler

recursive

Boolean

Grubun özyinelemeli olarak aranıp aranmayacağını belirten bir Boole değeri.

Döndürülenler

PrincipalSearchResult<Principal>

PrincipalSearchResult<T> Grubun üyesi olan asıl nesneleri içeren bir nesne veya grubun üyesi yoksa boş bir koleksiyon.

Örnekler

Aşağıdaki kod, kullanıcı adı "yönetici" ve parola oluşturucuda "SecretPwd123" olarak ayarlanmış şekilde LDAP etki alanına "fabrikam.com" PrincipalContext bağlanır.

"DC=fabrikam,DC=com" oluşturucusunda PrincipalContext belirtilen kapsayıcının altında "Domain Admins" adlı grubu bulmak için bir arama gerçekleştirilir. Grup bulunursa, özyinelemeli üyeler içeren bu grubun üyesi olan tüm sorumlular numaralandırılır

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

Açıklamalar

Özyinelemeli bayrağı olarak ayarlandığında truedöndürülen sorumlu koleksiyonu grup nesneleri içermez; yalnızca yaprak düğümler döndürülür. Örneğin, bir bilgisayar nesnesi ve bir grup nesnesi içeren bir grup (yalnızca kullanıcı sorumlularıyla) özyinelemeli olarak arandığında, döndürülen koleksiyon bilgisayar nesnesini ve iç içe gruptaki kullanıcı asıl nesnelerini içerir. Grup nesnesi bir yaprak olmadığından, boş olsa bile özyinelemeli aramada döndürülmüyor. Özyinelemeli bayrağı olarak ayarlandığında false, döndürülen koleksiyon grup nesneleri içerebilir.

Üyeler bağlama göre döndürülür. Örneğin, "CN=SpecialUsers,DC=Fabrikam,DC=com" temelinde bir AD DS bağlamı varsa PrincipalFindResult kümesi, aranan bağlamın parçası olmayan bir kapsamın altında olsalar bile "CN=NormalUsers,DC=Fabrikam,DC=com" altında bulunan grup üyelerini de içerir. Döndürülen sorumlu koleksiyonu, gruptan farklı bir depoda bulunan üyeleri de içerebilir.