GroupPrincipal.GetMembers Метод

Исходный код:

Group.cs

Исходный код:

Group.cs

Исходный код:

Group.cs

Исходный код:

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

Комментарии

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

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

Исходный код:

Group.cs

Исходный код:

Group.cs

Исходный код:

Group.cs

Исходный код:

Group.cs

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)

Параметры

Возвращаемое значение

Объект PrincipalSearchResult<T> , содержащий основные объекты, которые являются членами группы, или пустую коллекцию, если у группы нет членов.

Примеры

Следующий код подключается к домену LDAP "fabrikam.com" с именем пользователя, заданным "администратором", а пароль задан как 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", даже если они находятся под областью, которая не является частью контекста, который выполняется поиск. Возвращаемая коллекция субъектов также может содержать элементы, расположенные в другом хранилище, отличном от группы.