Freigeben über

PersonalizationProvider.FindState Methode

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Wenn eine abgeleitete Klasse überschrieben wird, wird eine Auflistung zurückgegeben, die null oder mehr PersonalizationStateInfoabgeleitete Objekte auf der Grundlage des Bereichs und spezifischer Abfrageparameter enthält.

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);
abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parameter

scope
PersonalizationScope

A PersonalizationScope mit den Personalisierungsinformationen, die abgefragt werden sollen. Dieser Wert darf nicht null sein.

query
PersonalizationStateQuery

A PersonalizationStateQuery containing a query. Dieser Wert kann null sein.

pageIndex
Int32

Der Speicherort, an dem die Abfrage gestartet wird.

pageSize
Int32

Die Anzahl der zurückzugebenden Datensätze.

totalRecords
Int32

Die Gesamtzahl der verfügbaren Datensätze.

Gibt zurück

PersonalizationStateInfoCollection

A PersonalizationStateInfoCollection containing zero or more PersonalizationStateInfo-derived objects.

Hinweise

Diese Methode ist die abstrakte Definition einer administrativen Methode zum Abfragen von Personalisierungsdaten. Abgeleitete Implementierungen sollten der unten beschriebenen Logik folgen.

Die Gruppe der zurückgegebenen Elemente wird durch die parameter pageSizepageSize und die pageIndex Anzahl der zurückzugebenden Datensätze eingeschränkt und pageIndex legt fest, welche Datensätze zurückgegeben werden sollen. Beispielsweise würde eine pageIndex von 0 und eine pageSize von 25 die ersten 25 Vorkommen zurückgeben, während eine pageIndex von 1 und pageSize 25 Vorkommen 26-50 zurückgeben würde. Wenn Sie alle verfügbaren Datensätze abrufen möchten, legen pageIndex Sie sie auf 0 und pageSize auf .MaxValue

Die PersonalizationStateInfovon -abgeleiteten Objekte werden in alphabetischer Reihenfolge zurückgegeben und nach einer Kombination ihrer Path Werte und Username Eigenschaftswerte in aufsteigender Reihenfolge sortiert.

Diese Methode übergibt Abfrage-Wildcardzeichen an den zugrunde liegenden Datenspeicher. Die Unterstützung für Platzhalterzeichen hängt derzeit davon ab, wie die einzelnen Anbieter Zeichen wie ein Sternchen (*), ein Prozentsymbol (%) oder einen Unterstrich (_) behandeln.

Normalerweise können Sie bei SQL-kompatiblen Datenspeichern eine Wildcardsuche auf einem teilseitigen Pfad ausführen, wobei das Wildcardzeichen am Anfang, am Ende oder in der Mitte des Suchzeichenfolgentexts in der PathToMatch Eigenschaft angezeigt wird. Um beispielsweise alle Pfade zu finden, die mit "~/vdir" beginnen, wird die PathToMatch Eigenschaft auf "~/vdir%" festgelegt.

Ebenso könnte eine Wildcardsuche nach einem teilweisen Benutzernamen das Wildcardzeichen an einem beliebigen Punkt in der Textzeichenfolge der UsernameToMatch Eigenschaft enthalten. Um beispielsweise alle Benutzernamen zu finden, die mit "John" beginnen, würde der UsernameToMatch Parameter wie "John%" aussehen.

Die folgenden Abfrageeinschränkungen gelten:

  • Wenn nur scope angegeben wird und query alle Eigenschaften für query die Rückgabe entweder null oder Standardwerte vorhanden sindnull, werden alle Datensätze zurückgegeben, die dem angegebenen scope Parameter entsprechen.

  • Ist die PathToMatch Eigenschaft nicht null, werden die zurückgegebenen Datensätze auch basierend auf Pfaden gefiltert, die dem PathToMatch Wert entsprechen.

  • Ist die UsernameToMatch Eigenschaft nicht null, werden die zurückgegebenen Datensätze auch basierend auf Benutzernamen gefiltert, die dem UsernameToMatch Eigenschaftswert entsprechen.

  • Wenn die UserInactiveSinceDate Eigenschaft nicht gleich MaxValueist, werden die zurückgegebenen Datensätze auch so gefiltert, dass nur die Datensätze zurückgegeben werden, die inaktiven Benutzern zugeordnet sind. Der Vergleich enthält Datensätze, bei denen die LastActivityDate Eigenschaft kleiner oder gleich der UserInactiveSinceDate Eigenschaft ist.

Beachten Sie, dass diese Methode keine Kombinationen von Abfrageparametern überprüft. Code kann z. B. eine Reihe von Personalisierungsstatuseinträgen anfordern, die einem bestimmten Benutzernamen im freigegebenen Bereich zugeordnet sind. Da Benutzernamen nicht mit freigegebenen Informationen verknüpft sind, wäre die zurückgegebene Sammlung leer.

Parameterkombinationen, die das Potenzial haben, eine nicht leere Auflistung zurückzugeben, umfassen:

Gilt für: