PersonalizationAdministration.GetCountOfUserState(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.