PersonalizationAdministration.GetCountOfUserState(String) Methode

Definitie

Retourneert een telling van de persoonlijke statusitems in het onderliggende gegevensarchief dat bestaat voor de opgegeven gebruiker.

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

Parameters

usernameToMatch
String

De gebruikersnaam die is gekoppeld aan de persoonlijke statusgegevens die moeten worden opgehaald.

Retouren

Het aantal persoonlijke statusitems voor de opgegeven gebruiker.

Uitzonderingen

usernameToMatch is een lege tekenreeks ("") na het bijsnijden.

– of –

De provider voor een personalisatieprovider die in de configuratie is gedefinieerd, is niet van het juiste type.

– of –

De lengte van de tekenreeks van een parameter is groter dan 256 tekens.

Er is een configuratie-uitzondering opgetreden bij het maken en initialiseren van een exemplaar van een van de geconfigureerde personalisatieproviders.

– of –

De standaardprovider voor persoonlijke instellingen die in de configuratie is gedefinieerd, is niet gevonden.

De standaardprovider heeft een negatief getal geretourneerd voor het aantal.

Opmerkingen

Deze methode retourneert een telling van het aantal persoonlijke items per gebruiker in het onderliggende gegevensarchief dat voor de opgegeven usernameToMatchgegevens bestaat.

Houd er rekening mee dat de usernameToMatch parameter jokertekens kan bevatten. Met deze methode worden jokertekens doorgegeven aan het onderliggende gegevensarchief. Ondersteuning voor jokertekens is momenteel afhankelijk van de manier waarop elke provider tekens verwerkt, zoals een sterretje (*), een procentsymbool (%) of een onderstrepingsteken (_).

Normaal gesproken kan voor sql-compatibele gegevensarchieven een jokertekenzoekopdracht op een gedeeltelijke gebruikersnaam het jokerteken op elk punt in de tekenreeks van de UsernameToMatch eigenschap weergeven. Als u bijvoorbeeld alle gebruikersnamen wilt zoeken die beginnen met 'John', ziet de UsernameToMatch parameter eruit als 'John%'.

De usernameToMatch parameter kan zijn null. Als deze optie is ingesteld null, wordt de parameter genegeerd bij het uitvoeren van query's. De parameter usernameToMatch mag komma's (,) hebben omdat sommige gegevensarchieven, zoals die waarop Microsoft SQL Server worden uitgevoerd, komma's als jokertekens toestaan.

Van toepassing op

Zie ook