Partager via


PersonalizationAdministration.GetCountOfUserState(String) Méthode

Définition

Retourne un compte des éléments d'état de personnalisation présents dans le magasin de données sous-jacent et qui existent pour l'utilisateur spécifié.

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

Paramètres

usernameToMatch
String

Nom d'utilisateur associé aux informations d'état de personnalisation à récupérer.

Retours

Nombre d'éléments d'état de personnalisation pour l'utilisateur spécifié.

Exceptions

usernameToMatch est une chaîne vide (""), une fois tronquée.

- ou -

Le fournisseur d’un fournisseur de personnalisation défini dans la configuration n’est pas du type correct.

- ou -

La longueur de la chaîne de tout paramètre doit être supérieure à 256 caractères.

Une exception de configuration s’est produite lors d’une tentative créer et d’initialiser une instance de l’un des fournisseurs de personnalisation configurés.

- ou -

Impossible de trouver le fournisseur de personnalisation par défaut défini dans la configuration.

Le fournisseur par défaut a retourné un nombre négatif pour le paramètre count.

Remarques

Cette méthode retourne le nombre d’éléments de personnalisation par utilisateur dans le magasin de données sous-jacent qui existent pour le donné usernameToMatch.

Notez que le usernameToMatch paramètre peut inclure des caractères génériques. Cette méthode transmet des caractères génériques au magasin de données sous-jacent. La prise en charge des caractères génériques dépend actuellement de la façon dont chaque fournisseur gère des caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

Normalement, pour les magasins de données compatibles SQL, une recherche générique sur un nom d’utilisateur partiel peut faire apparaître le caractère générique à n’importe quel point de la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur qui commencent par « John », le UsernameToMatch paramètre ressemblerait à « John% ».

Le usernameToMatch paramètre peut être null. Si la valeur nullest définie sur , le paramètre est ignoré lors de l’exécution des requêtes. Le usernameToMatch paramètre est autorisé à avoir des virgules (,), car certains magasins de données, tels que ceux exécutant Microsoft SQL Server, autorisent les virgules en tant que caractères génériques.

S’applique à

Voir aussi