PersonalizationAdministration.GetCountOfUserState(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> intPublic Shared Function GetCountOfUserState (usernameToMatch As String) As IntegerParamè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 l’élément 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 les caractères tels qu’un astérisque (*), un symbole de pourcentage (%), ou un trait de soulignement (_).
Normalement, pour les magasins de données conformes à SQL, une recherche générique sur un nom d’utilisateur partiel peut avoir le caractère générique apparaître à n’importe quel point dans la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur commençant par « John », le UsernameToMatch paramètre ressemble à « John % ».
Le usernameToMatch paramètre peut être null. Si la valeur est définie null, le paramètre est ignoré lors de l’exécution de requêtes. Le usernameToMatch paramètre est autorisé à avoir des virgules (,), car certains magasins de données, tels que ceux qui s’exécutent Microsoft SQL Server, autorisent les virgules en tant que caractères génériques.