SqlPersonalizationProvider.GetCountOfState Methode

  • Referenz

Definition

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

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

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

Parameter

scope
PersonalizationScope

Ein PersonalizationScope, der die abzufragenden Personalisierungsinformationen angibt. 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.

Ausnahmen

ArgumentException

PathToMatch ist ungleich null und nach dem Verkürzen eine leere Zeichenfolge ("").

- oder -

Die Länge von PathToMatch ist größer als 256 Zeichen, wenn der Wert ungleich null ist.

- oder -

UsernameToMatch ist ungleich null und nach dem Verkürzen eine leere Zeichenfolge.

- oder -

Die Länge von UsernameToMatch ist größer als 256 Zeichen, wenn der Wert ungleich null ist.

ArgumentOutOfRangeException

Der angegebene scope ist kein gültiger Wert aus der PersonalizationScope-Enumeration.

Hinweise

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

Normalerweise können Sie bei SQL-kompatiblen Datenspeichern eine Wildcardsuche für einen Teilpfad 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 "~/approot" beginnen, wird die PathToMatch -Eigenschaft auf "~/approot%" festgelegt.

Ebenso kann bei einer Wildcardsuche für einen teilweisen Benutzernamen das Wildcardzeichen an jeder Stelle 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 wird und querynull ist oder alle Eigenschaften sind query , die entweder null oder Standardwerte zurückgeben, werden alle Datensätze zurückgegeben, die dem angegebenen scope Parameter entsprechen.

  • Wenn die PathToMatch -Eigenschaft nicht nullist, werden die zurückgegebenen Datensätze ebenfalls nach Pfaden gefiltert, die dem PathToMatch Eigenschaftswert entsprechen.

  • Wenn nicht UsernameToMatchnullist, werden die zurückgegebenen Datensätze ebenfalls nach Benutzernamen gefiltert, die dem UsernameToMatch Eigenschaftswert entsprechen.

  • Wenn die UserInactiveSinceDate -Eigenschaft nicht gleich ist, werden die zurückgegebenen Datensätze ebenfalls 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 Zustandsdatensätzen anfordern, die inaktiven Benutzern im freigegebenen Bereich zugeordnet sind. Da es kein Konzept für inaktive Anpassungen gibt, wäre die zurückgegebene Anzahl null.

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

Gilt für: