GroupPrincipal.GetMembers 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

傳回包含在群組中的主體物件之集合。

多載

GetMembers()	傳回包含在群組中的主體物件之集合。
GetMembers(Boolean)	傳回包含在群組中的主體物件之集合。 當遞迴旗標設為 true 時，這個方法會遞迴地搜尋目前群組，並且傳回所有巢狀群組成員。

GetMembers()

來源:

Group.cs

傳回包含在群組中的主體物件之集合。

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)

傳回

PrincipalSearchResult<Principal>

PrincipalSearchResult<T> 物件，包含是群組成員的主體物件，如果群組沒有成員則為空集合。

備註

這個方法不會以遞歸方式搜尋目前的群組。 因此，群組物件可能會在主體物件集合中傳回。

成員會傳回，而不需遵守內容。 例如，如果以 “CN=SpecialUsers，DC=Fabrikam，DC=com” 為基礎的 AD DS 內容，PrincipalFindResult 集合也會包含位於 “CN=NormalUsers，DC=Fabrikam，DC=com” 底下的群組成員，即使它們落在不是搜尋內容一部分的範圍內也一樣。 傳回的主體集合也可能包含位於群組不同存放區的成員。

GetMembers(Boolean)

來源:

Group.cs

傳回包含在群組中的主體物件之集合。 當遞迴旗標設為 true 時，這個方法會遞迴地搜尋目前群組，並且傳回所有巢狀群組成員。

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)

參數

recursive

Boolean

指定是否會遞迴地搜尋群組的布林值。

傳回

PrincipalSearchResult<Principal>

PrincipalSearchResult<T> 物件，包含是群組成員的主體物件，如果群組沒有成員則為空集合。

範例

下列程式代碼會連線到LDAP網域 fabrikam.com“，並將使用者名稱設定為 ”administrator“，並將密碼設定為建構函式中的 PrincipalContext ”SecretPwd123“。

系統會執行搜尋，以在建構函式 「DC=fabrikam，DC=com」 中指定的 PrincipalContext 容器下尋找名稱為 「Domain Admins」 的群組。如果找到群組，則會列舉此群組成員的所有主體，其中包含遞歸成員

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

備註

當遞歸旗標設定為 true時，傳回的主體集合不包含群組物件;只會傳回分葉節點。 例如，當只有用戶主體的群組 (包含計算機物件和群組物件的群組時，會以遞歸方式搜尋) ，傳回的集合會包含計算機物件和巢狀群組中的用戶主體物件。 因為群組物件不是分葉，即使它是空的，它也不會在遞歸搜尋中傳回。 當遞歸旗標設定為 false時，傳回的集合可能包含群組物件。

成員會傳回，而不需遵守內容。 例如，如果以 “CN=SpecialUsers，DC=Fabrikam，DC=com” 為基礎的 AD DS 內容，PrincipalFindResult 集合也會包含位於 “CN=NormalUsers，DC=Fabrikam，DC=com” 底下的群組成員，即使它們落在不是搜尋內容一部分的範圍內也一樣。 傳回的主體集合也可能包含位於群組不同存放區的成員。