DirectorySearcher.SearchRoot Propriedade

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

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

[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }

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

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

[<System.DirectoryServices.DSDescription("DSSearchRoot")>]
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set

Public Property SearchRoot As DirectoryEntry

Valor de Propriedade

O objeto DirectoryEntry na hierarquia Active Directory Domain Services onde a pesquisa começa. O padrão é uma referência nula (Nothing em Visual Basic).

Atributos

DSDescriptionAttribute

Observações

Se SearchRoot for uma referência nula (Nothing em Visual Basic), a raiz de pesquisa é definida para a raiz do domínio que o seu servidor está a usar atualmente.

Existem várias formas de pesquisar no catálogo global:

• Enumera o catálogo global e escolhe o primeiro filho.

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

• Obtenha o RootDSE do catálogo global e peça "rootNamingContext".

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

• O código C# seguinte 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);