PersonalizationProvider.GetCountOfState Methode

  • Referenz

Definition

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

Wenn in einer abgeleiteten Klasse überschrieben, wird die Anzahl der Zeilen im zugrunde liegenden Datenspeicher zurückgegeben, die innerhalb des angegebenen Bereichs vorhanden sind.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parameter

scope
PersonalizationScope

Ein PersonalizationScope der Personalisierungsinformationen, die abgefragt werden sollen. Dieser Wert darf nicht null sein.

query
PersonalizationStateQuery

Eine PersonalizationStateQuery, die eine Abfrage enthält. Dieser Wert kann null sein.

Gibt zurück

Int32

Die Anzahl der Zeilen im zugrunde liegenden Datenspeicher, die für den angegebenen scope-Parameter vorhanden sind.

Hinweise

Diese Methode ist die abstrakte Definition einer Administrativen Methode zum Abrufen der Anzahl von Personalisierungsdaten. Abgeleitete Implementierungen sollten der unten beschriebenen Logik folgen.

Diese Methode übergibt Abfrageplatzhalterzeichen an den zugrunde liegenden Datenspeicher. Die Unterstützung von 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 Feldhaltersuche für einen teiligen Pfad ausführen, wobei das Feldhalterzeichen 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 kann bei einer Feldhaltersuche für einen teilweisen Benutzernamen das Feldhalterzeichen an jedem Punkt in der Textzeichenfolge der UsernameToMatch Eigenschaft angezeigt werden. Um beispielsweise alle Benutzernamen zu finden, die mit "John" beginnen, würde der UsernameToMatch Parameter wie "John%" aussehen.

Es gelten die folgenden Abfrageeinschränkungen:

  • Wenn nur scope angegeben ist und querynull oder alle Eigenschaften sind, die query entweder null oder Standardwerte zurückgeben, werden alle Datensätze gezählt, die dem angegebenen scope Parameter entsprechen.

  • Wenn die PathToMatch -Eigenschaft nicht nullist, werden die gezählten Datensätze auch nach Pfaden gefiltert, die dem PathToMatch Wert entsprechen.

  • Wenn die UsernameToMatch -Eigenschaft nicht nullist, werden die gezählten Datensätze auch nach Benutzernamen gefiltert, die dem UsernameToMatch Eigenschaftswert entsprechen.

  • Wenn die UserInactiveSinceDate Eigenschaft nicht gleich ist, werden auch die gezählten Datensätze gefiltert, um MaxValuenur die Datensätze zurückzugeben, die inaktiven Benutzern zugeordnet sind. Der Vergleich umfasst 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 beispielsweise eine Anzahl von Personalisierungszustandsdatensätzen anfordern, die einem bestimmten Benutzernamen im freigegebenen Bereich zugeordnet sind. Da Benutzernamen nicht mit freigegebenen Informationen verknüpft sind, ist die zurückgegebene Anzahl 0.

Parameterkombinationen, die das Potenzial haben, eine Nicht-Null-Anzahl zurückzugeben, umfassen:

Gilt für: