DirectoryVirtualListView 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
該 DirectoryVirtualListView 類別規定如何進行虛擬清單檢視搜尋。 虛擬清單檢視搜尋讓使用者能以地址簿風格的虛擬清單檢視方式查看搜尋結果。 它專門為非常龐大的結果集設計。 搜尋資料是在排序目錄搜尋的連續子集中取得的。
public ref class DirectoryVirtualListView
public class DirectoryVirtualListView
type DirectoryVirtualListView = class
Public Class DirectoryVirtualListView
- 繼承
-
DirectoryVirtualListView
範例
以下 C# 範例說明如何取得結果集中前 30 個項目。
using System.DirectoryServices;
...
DirectorySearcher src = new DirectorySearcher("…");
src.VirtualListView = new DirectoryVirtualListView(0,30);
foreach(SearchResult res in src.FindAll() )
{
Console.WriteLine("…");
}
以下 C# 範例展示了如何取得結果集中前 50 個以字母「Ha」開頭的項目。
using System.DirectoryServices;
...
DirectorySearcher src = new DirectorySearcher("…");
src.VirtualListView = new DirectoryVirtualListView(0,50, "Ha");
foreach(SearchResult res in src.FindAll() )
{
Console.WriteLine("…");
}
以下 C# 範例展示了如何在 60% 近似目標處取得前 100 個項目。
using System.DirectoryServices;
...
// First VLV calls.
DirectorySearcher src = new DirectorySearcher("…");
src.VirtualListView = new DirectoryVirtualListView(100);
foreach(SearchResult res in src.FindAll() )
{
Console.WriteLine("…");
}
// Second Call, the VLV context is still attached to the DirectorySearcher.
src.VirtualListView.TargetPercentage = 60;
src.VirtualListView.BeforeCount = 50;
src.VirtualListView.AfterCount = 50;
foreach(SearchResult res in src.FindAll() )
{
Console.WriteLine("…");
}
建構函式
| 名稱 | Description |
|---|---|
| DirectoryVirtualListView() |
初始化 DirectoryVirtualListView 類別的新執行個體。 |
| DirectoryVirtualListView(Int32, Int32, Int32, DirectoryVirtualListViewContext) |
初始化類別的新實例 DirectoryVirtualListView ,包含 before count、after count、offset 及 context set。 |
| DirectoryVirtualListView(Int32, Int32, Int32) |
初始化類別的新實例 DirectoryVirtualListView ,並以 before count、after count 和 offset 為 set。 |
| DirectoryVirtualListView(Int32, Int32, String, DirectoryVirtualListViewContext) |
初始化類別的新實例 DirectoryVirtualListView ,並設定 before、after count、target 與 context 。 |
| DirectoryVirtualListView(Int32, Int32, String) |
初始化該類別的新實例 DirectoryVirtualListView ,包含 before count、after count 和 target set。 |
| DirectoryVirtualListView(Int32) |
初始化類別的新實例 DirectoryVirtualListView ,並設定 After count。 |
屬性
| 名稱 | Description |
|---|---|
| AfterCount |
取得或設定一個值,表示客戶端在目標項目之後向伺服器請求的條目數量。 |
| ApproximateTotal |
取得或設定一個值,表示清單中項目的估計總數。 |
| BeforeCount |
取得或設定一個值,表示客戶端向伺服器請求的目標項目前的條目數量。 |
| DirectoryVirtualListViewContext |
取得或設定一個值以表示虛擬清單查看搜尋回應。 |
| Offset |
取得或設定一個值,以表示目標項目在列表中的偏移量。 |
| Target |
屬性 Target 會取得或設定一個值,用來表示客戶端所請求的目標項目。 |
| TargetPercentage |
屬性會 TargetPercentage 取得或設定一個值,表示估計目標條目的在列表中請求的偏移量,比例為清單中項目總數的百分比。 |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設哈希函式。 (繼承來源 Object) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |