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>, который содержит объекты-участники, являющиеся участниками группы, или пустую коллекцию, если в группе нет участников.

Комментарии

Этот метод не выполняет рекурсивный поиск в текущей группе. Таким образом, объекты группы могут быть возвращены в основной коллекции объектов.

Элементы возвращаются без учета контекста. Например, если контекст AD DS, основанный на "CN=SpecialUsers,DC=Fabrikam,DC=com", набор 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 и паролем SecretPwd123 в конструкторе PrincipalContext .

Выполняется поиск группы с именем "Администраторы домена" в контейнере, указанном в PrincipalContext конструкторе "DC=fabrikam,DC=com". Если группа найдена, то перечисляются все субъекты, являющиеся членами этой группы, в том числе рекурсивные члены.

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, возвращаемая коллекция может содержать объекты группы.

Элементы возвращаются без учета контекста. Например, если контекст AD DS, основанный на "CN=SpecialUsers,DC=Fabrikam,DC=com", набор PrincipalFindResult также будет включать членов группы, расположенных в разделе "CN=NormalUsers,DC=Fabrikam,DC=com", даже если они подпадают под область, которая не является частью контекста поиска. Возвращаемая основная коллекция также может содержать элементы, расположенные в хранилище, отличном от хранилища группы.