PersonalizationAdministration.GetCountOfUserState(String) Methode
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.
Gibt die Anzahl der Personalisierungszustandselemente im zugrunde liegenden Datenspeicher zurück, die für den angegebenen Benutzer vorhanden sind.
public:
static int GetCountOfUserState(System::String ^ usernameToMatch);public static int GetCountOfUserState (string usernameToMatch);static member GetCountOfUserState : string -> intPublic Shared Function GetCountOfUserState (usernameToMatch As String) As IntegerParameter
- usernameToMatch
- String
Der den abzurufenden Personalisierungszustandsinformationen zugeordnete Benutzername.
Gibt zurück
Die Anzahl der Personalisierungszustandselemente für den angegebenen Benutzer.
Ausnahmen
usernameToMatch entspricht nach dem Verkürzen einer leeren Zeichenfolge ("").
- oder -
Der Anbieter für einen in der Konfiguration definierten Personalisierungsanbieter weist nicht den richtigen Typ auf.
- oder -
Die Länge der Zeichenfolge eines beliebigen Parameters beträgt mehr als 256 Zeichen.
Beim Versuch, eine Instanz eines konfigurierten Personalisierungsanbieters zu erstellen und zu initialisieren, ist eine Konfigurationsausnahme aufgetreten.
- oder -
Der in der Konfiguration definierte standardmäßige Personalisierungsanbieter wurde nicht gefunden.
Der Standardanbieter hat als Anzahl eine negative Zahl zurückgegeben.
Hinweise
Diese Methode gibt die Anzahl der Personalisierungselemente pro Benutzer im zugrunde liegenden Datenspeicher zurück, die für den angegebenen usernameToMatchvorhanden sind.
Beachten Sie, dass der usernameToMatch Parameter Wildcardzeichen enthalten kann. Diese Methode übergibt Wildcardzeichen 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 kann bei SQL-kompatiblen Datenspeichern bei einer Wildcardsuche für einen partiellen Benutzernamen das Wildcardzeichen 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.
Der usernameToMatch Parameter kann sein null. Bei Festlegung auf nullwird der Parameter beim Ausführen von Abfragen ignoriert. Der usernameToMatch Parameter darf Kommas (,) enthalten, da einige Datenspeicher, z. B. solche, die Microsoft SQL Server ausführen, Kommas als Wildcardzeichen zulassen.
