GroupPrincipal.GetMembers Metode

Definisi

Ruang nama:

System.DirectoryServices.AccountManagement

Rakitan:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Mengembalikan kumpulan objek utama yang terkandung dalam grup.

Overload

GetMembers()	Mengembalikan kumpulan objek utama yang terkandung dalam grup.
GetMembers(Boolean)	Mengembalikan kumpulan objek utama yang terkandung dalam grup. Ketika bendera rekursif diatur ke true, metode ini mencari grup saat ini secara rekursif dan mengembalikan semua anggota grup berlapis.

GetMembers()

Sumber:

Group.cs

Mengembalikan kumpulan objek utama yang terkandung dalam grup.

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)

Mengembalikan

PrincipalSearchResult<Principal>

Objek PrincipalSearchResult<T> yang berisi objek utama yang merupakan anggota grup, atau koleksi kosong jika grup tidak memiliki anggota.

Keterangan

Metode ini tidak mencari grup saat ini secara rekursif. Oleh karena itu, objek grup dapat dikembalikan dalam koleksi objek utama.

Anggota dikembalikan tanpa menghormati konteks. Misalnya, jika konteks AD DS yang berbasis di "CN=SpecialUsers,DC=Fabrikam,DC=com", set PrincipalFindResult akan menyertakan anggota grup yang terletak di bawah "CN=NormalUsers,DC=Fabrikam,DC=com" juga, meskipun mereka berada di bawah cakupan yang bukan bagian dari konteks yang dicari. Koleksi utama yang dikembalikan juga dapat berisi anggota yang terletak di penyimpanan yang berbeda dari grup.

GetMembers(Boolean)

Sumber:

Group.cs

Mengembalikan kumpulan objek utama yang terkandung dalam grup. Ketika bendera rekursif diatur ke true, metode ini mencari grup saat ini secara rekursif dan mengembalikan semua anggota grup berlapis.

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)

Parameter

recursive

Boolean

Nilai Boolean yang menentukan apakah grup dicari secara rekursif.

Mengembalikan

PrincipalSearchResult<Principal>

Objek PrincipalSearchResult<T> yang berisi objek utama yang merupakan anggota grup, atau koleksi kosong jika grup tidak memiliki anggota.

Contoh

Kode berikut terhubung ke domain LDAP "fabrikam.com" dengan nama pengguna diatur ke "administrator" dan kata sandi diatur ke "SecretPwd123" di PrincipalContext konstruktor.

Pencarian dilakukan untuk menemukan grup yang memiliki nama "Admin Domain" di bawah kontainer yang ditentukan dalam PrincipalContext konstruktor "DC=fabrikam,DC=com." Jika grup ditemukan, semua prinsipal yang merupakan anggota grup ini, yang mencakup anggota rekursif, kemudian dijumlahkan

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

Keterangan

Koleksi utama yang dikembalikan tidak berisi objek grup ketika bendera rekursif diatur ke true; hanya simpul daun yang dikembalikan. Misalnya, ketika grup yang berisi objek komputer dan objek grup (hanya dengan prinsipal pengguna) dicari secara rekursif, koleksi yang dikembalikan berisi objek komputer dan objek utama pengguna dalam grup berlapis. Karena objek grup bukan daun, bahkan ketika kosong, objek tersebut tidak dikembalikan dalam pencarian rekursif. Ketika bendera rekursif diatur ke false, koleksi yang dikembalikan mungkin berisi objek grup.

Anggota dikembalikan tanpa menghormati konteks. Misalnya, jika konteks AD DS yang berbasis di "CN=SpecialUsers,DC=Fabrikam,DC=com", set PrincipalFindResult akan menyertakan anggota grup yang terletak di bawah "CN=NormalUsers,DC=Fabrikam,DC=com" juga, meskipun mereka berada di bawah cakupan yang bukan bagian dari konteks yang dicari. Koleksi utama yang dikembalikan juga dapat berisi anggota yang terletak di penyimpanan yang berbeda dari grup.