Teilen über

PersonalizationAdministration.GetCountOfUserState(String) Methode

  • Referenz

Definition

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

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 -> int
Public Shared Function GetCountOfUserState (usernameToMatch As String) As Integer

Parameter

usernameToMatch
String

Der den abzurufenden Personalisierungszustandsinformationen zugeordnete Benutzername.

Gibt zurück

Int32

Die Anzahl der Personalisierungszustandselemente für den angegebenen Benutzer.

Ausnahmen

ArgumentException

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.

ConfigurationErrorsException

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.

HttpException

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.

Gilt für:

Weitere Informationen