SearchResult.GetDirectoryEntry Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает из иерархии доменных служб Active Directory объект DirectoryEntry, соответствующий объекту SearchResult.
public:
System::DirectoryServices::DirectoryEntry ^ GetDirectoryEntry();
public System.DirectoryServices.DirectoryEntry GetDirectoryEntry ();
member this.GetDirectoryEntry : unit -> System.DirectoryServices.DirectoryEntry
Public Function GetDirectoryEntry () As DirectoryEntry
Возвращаемое значение
Объект DirectoryEntry, соответствующий параметру SearchResult.
Примеры
Следующий пример является выдержкой из примера в SearchResult . В исходном примере создается новый DirectoryEntry объект с нужным путем и используется FindOne метод для запуска поиска. После выполнения поиска в примере используется GetDirectoryEntry метод для получения записи каталога в реальном времени, указанной в результатах поиска.
' Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
Dim myDirectoryEntry As DirectoryEntry = mySearchResult.GetDirectoryEntry()
Console.WriteLine(ControlChars.Newline + "The name of the 'myDirectoryEntry' " + _
"directory entry that corresponds to the " + _
"'mySearchResult' search result is : {0}" + _
ControlChars.Newline, myDirectoryEntry.Name)
// Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
DirectoryEntry myDirectoryEntry =
mySearchResult.GetDirectoryEntry();
Console.WriteLine("\nThe name of the 'myDirectoryEntry' " +
"directory entry that corresponds to the " +
"'mySearchResult' search result is : {0}\n",
myDirectoryEntry.Name);
// Get the 'DirectoryEntry' that corresponds to 'mySearchResult'.
DirectoryEntry^ myDirectoryEntry = mySearchResult->GetDirectoryEntry();
Console::WriteLine(
String::Concat("\nThe name of the 'myDirectoryEntry' ",
"directory entry that corresponds to the ",
"'mySearchResult' search result is : {0}\n"),
myDirectoryEntry->Name);
Комментарии
Используйте GetDirectoryEntry , если нужно просмотреть запись в режиме реального времени вместо записи, которая была возвращена DirectorySearcher , или когда требуется вызвать метод для возвращенного объекта.
Примечание
Вызов GetDirectoryEntry по каждому из SearchResult возвращаемых методов DirectorySearcher может выполняться очень долго.