Freigeben über

PersonalizationProvider.GetCountOfState Methode

Definition

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

Wenn eine abgeleitete Klasse überschrieben wird, 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

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

query
PersonalizationStateQuery

A PersonalizationStateQuery containing a query. 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 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, die dem angegebenen scope Parameter entsprechen, gezählt.

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

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

  • Wenn die UserInactiveSinceDate Eigenschaft nicht gleich MaxValueist, werden die gezählten 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 Anzahl von Personalisierungsstatuseinträgen anfordern, die einem bestimmten Benutzernamen im freigegebenen Bereich zugeordnet sind. Da Benutzernamen nicht mit freigegebenen Informationen verknüpft sind, ist die zurückgegebene Anzahl null.

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

Gilt für: