GroupPrincipal.GetMembers Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
- Kaynak:
- Group.cs
- 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<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.
Şunlara uygulanır
GetMembers(Boolean)
- Kaynak:
- Group.cs
- Kaynak:
- Group.cs
- 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<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.
