DirectoryVirtualListView Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die DirectoryVirtualListView-Klasse gibt an, wie eine virtuelle Listenansichtssuche ausgeführt wird. Diese Art der Suche ermöglicht Benutzern die Ansicht von Suchergebnissen in virtuellen Listen im Adressbuchstil. Diese Suche ist speziell für sehr große Resultsets vorgesehen. Suchdaten werden in zusammenhängenden Teilmengen einer sortierten Verzeichnissuche abgerufen.
public ref class DirectoryVirtualListViewpublic class DirectoryVirtualListViewtype DirectoryVirtualListView = classPublic Class DirectoryVirtualListView- Vererbung
-
DirectoryVirtualListView
Beispiele
Das folgende C#-Beispiel zeigt, wie die ersten 30 Einträge in einem Resultset abgerufen werden.
using System.DirectoryServices;
...
DirectorySearcher src = new DirectorySearcher("…");
src.VirtualListView = new DirectoryVirtualListView(0,30);
foreach(SearchResult res in src.FindAll() )
{
Console.WriteLine("…");
}
Das folgende C#-Beispiel zeigt, wie die ersten 50 Einträge in einem Resultset abgerufen werden, die mit den Buchstaben "Ha" beginnen.
using System.DirectoryServices;
...
DirectorySearcher src = new DirectorySearcher("…");
src.VirtualListView = new DirectoryVirtualListView(0,50, "Ha");
foreach(SearchResult res in src.FindAll() )
{
Console.WriteLine("…");
}
Im folgenden C#-Beispiel wird veranschaulicht, wie die ersten 100 Einträge am ungefähren Ziel von 60 % abgerufen werden.
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("…");
}
Konstruktoren
| DirectoryVirtualListView() |
Initialisiert eine neue Instanz der DirectoryVirtualListView-Klasse. |
| DirectoryVirtualListView(Int32) |
Initialisiert eine neue Instanz der DirectoryVirtualListView-Klasse mit der festgelegten Anzahl der Einträge nach dem Zieleintrag. |
| DirectoryVirtualListView(Int32, Int32, Int32) |
Initialisiert eine neue Instanz der DirectoryVirtualListView-Klasse mit der festgelegten Anzahl der Einträge vor dem Zieleintrag, nach dem Zieleintrag und dem festgelegten Offset. |
| DirectoryVirtualListView(Int32, Int32, Int32, DirectoryVirtualListViewContext) |
Initialisiert eine neue Instanz der DirectoryVirtualListView-Klasse mit der festgelegten Anzahl der Einträge vor dem Zieleintrag, nach dem Zieleintrag sowie dem festgelegten Offset und Kontext. |
| DirectoryVirtualListView(Int32, Int32, String) |
Initialisiert eine neue Instanz der DirectoryVirtualListView-Klasse mit der festgelegten Anzahl der Einträge vor dem Zieleintrag, nach dem Zieleintrag und dem festgelegten Zieleintrag. |
| DirectoryVirtualListView(Int32, Int32, String, DirectoryVirtualListViewContext) |
Initialisiert eine neue Instanz der DirectoryVirtualListView-Klasse mit der festgelegten Anzahl der Einträge vor dem Zieleintrag, nach dem Zieleintrag sowie dem festgelegten Zieleintrag und dem festgelegten Kontext. |
Eigenschaften
| AfterCount |
Ruft einen Wert ab, der die Anzahl von Einträgen nach dem Zieleintrag angibt, den der Client vom Server anfordert, oder legt diesen fest. |
| ApproximateTotal |
Ruft einen Wert ab, der die geschätzte Gesamtanzahl der Elemente in der Liste angibt, oder legt diesen fest. |
| BeforeCount |
Ruft einen Wert ab, der die Anzahl von Einträgen vor dem Zieleintrag angibt, den der Client vom Server anfordert, oder legt diesen fest. |
| DirectoryVirtualListViewContext |
Ruft einen Wert ab, der die virtuelle Listenansichtssuchantwort angibt, oder legt diesen fest. |
| Offset |
Ruft einen Wert ab, der den Offset des Zieleintrags innerhalb der Liste angibt, oder legt diesen fest. |
| Target |
Die Target-Eigenschaft ruft einen Wert ab, der den vom Client angeforderten gewünschten Zieleintrag angibt, oder legt diesen fest. |
| TargetPercentage |
Die TargetPercentage-Eigenschaft ruft einen Wert ab, der den geschätzten angeforderten Offset des Zieleintrags innerhalb der Liste als prozentualen Anteil der Gesamtanzahl der Elemente in der Liste angibt, oder legt diesen Wert fest. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
