System.DirectoryServices Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece fácil acesso a Active Directory Domain Services do código gerenciado. O namespace contém duas classes de componente, DirectoryEntry e DirectorySearcher, que usam a tecnologia ADSI (Interfaces de Serviços Active Directory). ADSI é o conjunto de interfaces que Microsoft fornece como uma ferramenta flexível para trabalhar com uma variedade de provedores de rede. O ADSI fornece ao administrador a capacidade de localizar e gerenciar recursos em uma rede com relativa facilidade, independentemente do tamanho da rede.
Classes
| Nome | Description |
|---|---|
| ActiveDirectoryAccessRule |
A classe ActiveDirectoryAccessRule é usada para representar uma ACE (entrada de controle de acesso) na DACL (lista de controle de acesso discricionário) de um objeto Active Directory Domain Services. |
| ActiveDirectoryAuditRule |
O ActiveDirectoryAuditRule é usado para definir uma ACE (entrada de controle de acesso) em uma SACL (lista de controle de acesso do sistema). Contém ActiveDirectoryAccessRule o administrador, que é representado como um IdentityReference objeto. Ele também contém informações sobre o tipo de controle de acesso, máscara de acesso e outras propriedades, como sinalizadores de herança. Essa regra é definida em um ActiveDirectorySecurity objeto. Após o ActiveDirectorySecurity compromisso com o repositório de diretórios, ele modificará o objeto descritor de segurança de acordo com as regras definidas.ActiveDirectoryAuditRule |
| ActiveDirectorySecurity |
Usa a camada de segurança de objeto da biblioteca de ACL gerenciada para encapsular a funcionalidade de controle de acesso para objetos de diretório. |
| CreateChildAccessRule |
A classe CreateChildAccessRule representa um tipo específico de regra de acesso que é usada para permitir ou negar a um objeto Active Directory Domain Services o direito de criar objetos filho. |
| DeleteChildAccessRule |
A classe DeleteChildAccessRule representa um tipo específico de regra de acesso que é usada para permitir ou negar a um objeto Active Directory Domain Services o direito de excluir objetos filho. |
| DeleteTreeAccessRule |
A classe DeleteTreeAccessRule representa um tipo específico de regra de acesso que é usada para permitir ou negar a um objeto Active Directory Domain Services o direito de excluir todos os objetos filho, independentemente das permissões que os objetos filho têm. |
| DirectoryEntries |
Contém uma coleção de DirectoryEntry objetos. |
| DirectoryEntry |
A classe DirectoryEntry encapsula um nó ou objeto na hierarquia Active Directory Domain Services. |
| DirectoryEntryConfiguration |
A DirectoryEntryConfiguration classe fornece uma maneira direta de especificar e obter opções específicas do provedor para manipular um objeto de diretório. Normalmente, as opções se aplicam às operações de pesquisa do repositório de diretórios subjacente. As opções com suporte são específicas do provedor. |
| DirectorySearcher |
Executa consultas em Active Directory Domain Services. |
| DirectoryServicesCOMException |
Contém informações de erro estendidas sobre um erro que ocorreu quando o Invoke(String, Object[]) método é chamado. |
| DirectoryServicesPermission |
A DirectoryServicesPermission classe permite que você controle as permissões de segurança de acesso ao código para System.DirectoryServices. |
| DirectoryServicesPermissionAttribute |
Permite verificações de permissão declarativa System.DirectoryServices . |
| DirectoryServicesPermissionEntry |
A DirectoryServicesPermissionEntry classe define a menor unidade de um conjunto de permissões de segurança de acesso de código para System.DirectoryServices. |
| DirectoryServicesPermissionEntryCollection |
Contém uma coleção fortemente tipada de DirectoryServicesPermissionEntry objetos. |
| DirectorySynchronization |
Especifica como sincronizar um diretório em um domínio. |
| DirectoryVirtualListView |
A DirectoryVirtualListView classe especifica como conduzir uma pesquisa de exibição de lista virtual. Uma pesquisa de exibição de lista virtual permite que os usuários exibam os resultados da pesquisa como exibições de lista virtual de estilo de catálogo de endereços. Ele foi projetado especificamente para conjuntos de resultados muito grandes. Os dados de pesquisa são recuperados em subconjuntos contíguos de uma pesquisa de diretório classificada. |
| DirectoryVirtualListViewContext |
Especifica como construir a resposta de exibição de lista virtual do diretório. |
| DSDescriptionAttribute |
Dá suporte à infraestrutura do .NET Framework e não se destina a ser usada diretamente do código. |
| ExtendedRightAccessRule |
Representa um tipo específico de regra de acesso que é usado para permitir ou negar um objeto Active Directory um direito estendido. Os direitos estendidos são operações especiais que não são cobertas pelo conjunto padrão de direitos de acesso. Um exemplo de um direito estendido é Send-As, que dá a um usuário o direito de enviar email para outro usuário. Para obter uma lista de possíveis direitos estendidos, consulte o artigo Direitos Estendidos . Para obter mais informações sobre direitos estendidos, consulte os Direitos de Acesso de Controle. |
| ListChildrenAccessRule |
A classe ListChildrenAccessRule representa um tipo específico de regra de acesso que é usada para permitir ou negar a um objeto Active Directory Domain Services o direito de listar objetos filho. |
| PropertyAccessRule |
A classe PropertyAccessRule representa um tipo específico de regra de acesso que é usada para permitir ou negar acesso a uma propriedade Active Directory Domain Services. |
| PropertyCollection |
A PropertyCollection classe contém as propriedades de um DirectoryEntry. |
| PropertySetAccessRule |
A classe PropertySetAccessRule representa um tipo específico de regra de acesso que é usada para permitir ou negar acesso a um conjunto de propriedades Active Directory Domain Services. Para obter uma lista de conjuntos de propriedades definidos para Active Directory Domain Services, consulte o artigo Property Sets. |
| PropertyValueCollection |
Contém os valores de uma DirectoryEntry propriedade. |
| ResultPropertyCollection |
Contém as propriedades de uma SearchResult instância. |
| ResultPropertyValueCollection |
Contém os valores de uma SearchResult propriedade. |
| SchemaNameCollection |
Contém uma lista dos nomes de esquema que a SchemaFilter propriedade de um DirectoryEntries objeto pode usar. |
| SearchResult |
A classe SearchResult encapsula um nó na hierarquia de Active Directory Domain Services que é retornado durante uma pesquisa por DirectorySearcher. |
| SearchResultCollection |
A classe SearchResultCollection contém as instâncias SearchResult que a hierarquia Active Directory retornou durante uma consulta DirectorySearcher. |
| SearchWaitHandler |
Uma classe que lida com o tratamento de espera de pesquisa. |
| SortOption |
Especifica como classificar os resultados de uma pesquisa. |
Enumerações
| Nome | Description |
|---|---|
| ActiveDirectoryRights |
A enumeração ActiveDirectoryRights especifica os direitos de acesso atribuídos a um objeto Active Directory Domain Services. |
| ActiveDirectorySecurityInheritance |
A enumeração ActiveDirectorySecurityInheritance especifica se, e como, as informações ace são aplicadas a um objeto e seus descendentes. |
| AuthenticationTypes |
A enumeração AuthenticationTypes especifica os tipos de autenticação usados no System.DirectoryServices. Essa enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit de seus valores de membro. |
| DereferenceAlias |
A enumeração DereferenceAlias especifica como os aliases são resolvidos. Essa enumeração fornece valores para a propriedade DerefAlias. |
| DirectoryServicesPermissionAccess |
A enumeração DirectoryServicesPermissionAccess define os níveis de acesso usados por classes de permissão System.DirectoryServices. Essa enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit de seus valores de membro. |
| DirectorySynchronizationOptions |
Contém sinalizadores que determinam como os diretórios dentro de um domínio serão sincronizados. Essas opções podem ser definidas para a propriedade Option. |
| ExtendedDN |
A enumeração ExtendedDN especifica o formato no qual retornar o nome diferenciado estendido. Essa enumeração é usada com a propriedade ExtendedDN. |
| PasswordEncodingMethod |
Especifica se o SSL é usado quando você define ou altera uma senha. Essa enumeração é usada com a propriedade PasswordEncoding. |
| PropertyAccess |
A enumeração PropertyAccess é usada com as classes PropertyAccessRule e PropertySetAccessRule para indicar o tipo de acesso aplicado a uma propriedade Active Directory ou conjunto de propriedades. |
| ReferralChasingOption |
A enumeração ReferralChasingOption especifica se e como a busca de referência é perseguida. |
| SearchScope |
Especifica os escopos possíveis para uma pesquisa de diretório que é executada usando o objeto DirectorySearcher. |
| SecurityMasks |
Especifica as opções disponíveis para examinar informações de segurança de um objeto de diretório. Essa enumeração é usada com as propriedades SecurityMasks e SecurityMasks. |
| SortDirection |
A enumeração SortDirection especifica como classificar os resultados de uma consulta Active Directory Domain Services. |
Comentários
As classes nesse namespace podem ser usadas com qualquer um dos provedores de serviços Active Directory Domain Services. Os provedores atuais são: Serviços de Informações da Internet (IIS), LDAP (Lightweight Directory Access Protocol), NDS (Novell NetWare Directory Service) e WinNT.
ADSI é uma interface programática para Microsoft Active Directory Domain Services que permite que seus aplicativos interajam com diretórios diversos em uma rede usando uma única interface. Usando ADSI, você pode criar aplicativos que executam tarefas comuns, como fazer backup de bancos de dados, acessar impressoras e administrar contas de usuário.
Supõe-se que você tenha uma compreensão geral de Active Directory Domain Services antes de usar essas classes. Para obter mais informações sobre Active Directory Domain Services, consulte os seguintes tópicos:
Active Directory Domain Services usar uma estrutura de árvore. Cada nó na árvore contém um conjunto de propriedades. Use esse namespace para percorrer, pesquisar e modificar a árvore e ler e gravar nas propriedades de um nó.
A classe DirectoryEntry encapsula um nó ou objeto na hierarquia Active Directory Domain Services. Use essa classe para associar a objetos, ler propriedades e atualizar atributos. Juntamente com classes auxiliares, DirectoryEntry fornece suporte para métodos de gerenciamento e navegação do ciclo de vida, incluindo a criação, exclusão, renomeação, movimentação de um nó filho e enumeração de filhos.
Use a classe DirectorySearcher para executar consultas na hierarquia Active Directory Domain Services. O LDAP é o único provedor ADSI (Interfaces de Serviço Active Directory) fornecido pelo sistema que dá suporte à pesquisa.
Uma pesquisa da hierarquia de Active Directory Domain Services por meio de DirectorySearcher retorna instâncias de SearchResult, que estão contidas em uma instância da classe SearchResultCollection.