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 le nombre d’éléments d’état de personnalisation dans le magasin de données sous-jacent 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 (« ») après la suppression.
- 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 d’un paramètre est supérieure à 256 caractères.
Une exception de configuration s’est produite lors de la tentative de création et d’initialisation d’une instance de l’un des fournisseurs de personnalisation configurés.
- ou -
Le fournisseur de personnalisation par défaut défini dans la configuration est introuvable.
Le fournisseur par défaut a retourné un nombre négatif pour le nombre.
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 ressemblerait à « 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 exécutant Microsoft SQL Server, autorisent les virgules en tant que caractères génériques.
