SearchResultCollection.Handle 属性

定义

获取由执行实际搜索的方法返回 IDirectorySearch::ExecuteSearch 的句柄。 有关详细信息,请参阅 IDirectorySearch::ExecuteSearch 一文。

C#
public IntPtr Handle { get; }

属性值

IntPtr

此集合使用的 ADS_SEARCH_HANDLE 值。

注解

DirectorySearcher创建此集合的 调用 IDirectorySearch::ExecuteSearch 方法,使查询结果对 SearchResultCollection 对象可用。 有关详细信息,请参阅 IDirectorySearch::ExecuteSearch 一文。

每次执行查询时,该查询结果的句柄都与其 SearchResultCollection 对象相关联。 此句柄对应于 ADSI 中的搜索句柄。 此句柄一直持续到你对 对象调用 Dispose() 方法为止,因此必须调用 Dispose() 以防止内存SearchResultCollection泄漏。 垃圾回收器不会释放此特定对象的内存。

适用于

产品 版本
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10