GroupPrincipal.GetMembers Método

Definição

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacote:

System.DirectoryServices.AccountManagement v8.0.0

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.

Sobrecargas

GetMembers()	Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.
GetMembers(Boolean)	Retorna uma coleção de objetos de entidade de segurança que está contida no grupo. Quando esse sinalizador é definido como verdadeiro, este método pesquisa recursivamente o grupo atual e retorna todos os membros do grupo.

GetMembers()

Origem:

Group.cs

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo.

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)

Retornos

PrincipalSearchResult<Principal>

Um PrincipalSearchResult<T> objeto que contém os objetos de entidade de segurança que são membros do grupo ou uma coleção vazia se o grupo não tem membros.

Comentários

Esse método não pesquisa o grupo atual recursivamente. Portanto, objetos de grupo podem ser retornados na coleção de objetos principal.

Os membros são retornados sem respeito ao contexto. Por exemplo, se um contexto do AD DS baseado em "CN=SpecialUsers,DC=Fabrikam,DC=com", o conjunto PrincipalFindResult incluirá membros do grupo localizados em "CN=NormalUsers,DC=Fabrikam,DC=com", mesmo que eles estejam sob um escopo que não faz parte do contexto pesquisado. A coleção principal retornada também pode conter membros localizados em um repositório diferente do grupo.

GetMembers(Boolean)

Origem:

Group.cs

Retorna uma coleção de objetos de entidade de segurança que está contida no grupo. Quando esse sinalizador é definido como verdadeiro, este método pesquisa recursivamente o grupo atual e retorna todos os membros do grupo.

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)

Parâmetros

recursive

Boolean

Um valor booliano que especifica se o grupo é pesquisado recursivamente.

Retornos

PrincipalSearchResult<Principal>

Um PrincipalSearchResult<T> objeto que contém os objetos de entidade de segurança que são membros do grupo ou uma coleção vazia se o grupo não tem membros.

Exemplos

O código a seguir conecta-se ao domínio LDAP "fabrikam.com" com o nome de usuário definido como "administrador" e a senha definida como "SecretPwd123" no PrincipalContext construtor.

Uma pesquisa é executada para localizar o grupo que tem o nome "Administradores de Domínio" no contêiner especificado no PrincipalContext construtor "DC=fabrikam,DC=com". Se o grupo for encontrado, todas as entidades de segurança que são membros desse grupo, que inclui membros recursivos, serão enumeradas

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

Comentários

A coleção principal retornada não contém objetos de grupo quando o sinalizador recursivo é definido truecomo ; somente nós folha são retornados. Por exemplo, quando um grupo que contém um objeto de computador e um objeto de grupo (com apenas entidades de usuário) é pesquisado recursivamente, a coleção retornada contém o objeto de computador e os objetos de entidade de segurança do usuário no grupo aninhado. Como o objeto de grupo não é uma folha, mesmo quando está vazio, ele não é retornado na pesquisa recursiva. Quando o sinalizador recursivo é definido falsecomo , a coleção retornada pode conter objetos de grupo.

Os membros são retornados sem respeito ao contexto. Por exemplo, se um contexto do AD DS baseado em "CN=SpecialUsers,DC=Fabrikam,DC=com", o conjunto PrincipalFindResult incluirá membros do grupo localizados em "CN=NormalUsers,DC=Fabrikam,DC=com", mesmo que eles estejam sob um escopo que não faz parte do contexto pesquisado. A coleção principal retornada também pode conter membros localizados em um repositório diferente do grupo.