DirectorySearcher.SearchRoot Propriedade

Definição

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Pacote:

System.DirectoryServices v8.0.0

Origem:

DirectorySearcher.cs

Obtém ou define um valor que indica o nó da hierarquia do Active Directory Domain Services onde a pesquisa se inicia.

public:
 property System::DirectoryServices::DirectoryEntry ^ SearchRoot { System::DirectoryServices::DirectoryEntry ^ get(); void set(System::DirectoryServices::DirectoryEntry ^ value); };

public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }

member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set

Public Property SearchRoot As DirectoryEntry

Valor da propriedade

DirectoryEntry

O objeto DirectoryEntry na hierarquia do Active Directory Domain Services onde a pesquisa se inicia. O padrão é uma referência nula (Nothing no Visual Basic).

Comentários

Se SearchRoot for uma referência nula (Nothing no Visual Basic), a raiz de pesquisa será definida como a raiz do domínio que seu servidor está usando no momento.

Há várias maneiras de pesquisar no catálogo global:

• Enumerar o catálogo global e escolher o primeiro filho.

• Especifique o nome do servidor. Use a função DsGetDcName para localizar o catálogo global. Para obter mais informações sobre a função DsGetDcName, consulte dsGetDcName.

• Obtenha o RootDSE do catálogo global e solicite "rootNamingContext".

• Use o catálogo global, especificando um caminho de pesquisa como se estivesse usando LDAP. Por exemplo, "GC://OU=..., DC=..., DC=...".

• O código C# a seguir mostra como enumerar o catálogo global e escolher o primeiro filho.

  DirectoryEntry entry = new DirectoryEntry("GC://forestname");  
  IEnumerator ie = entry.Children.GetEnumerator();  
  ie.MoveNext();  
  entry = (DirectoryEntry)ie.Current;  
  DirectorySearcher search = new DirectorySearcher(entry);