Partager via


PersonalizationProvider.GetCountOfState Méthode

Définition

En cas de substitution dans une classe dérivée, retourne le nombre de lignes présentes dans le magasin de données sous-jacent également présentes dans la portée spécifiée.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Paramètres

scope
PersonalizationScope

PersonalizationScope des informations de personnalisation à rechercher. Cette valeur ne peut pas être null.

query
PersonalizationStateQuery

PersonalizationStateQuery contenant une requête. Cette valeur peut être null.

Retours

Nombre de lignes présentes dans le magasin de données sous-jacent qui existent pour le paramètre scope spécifié.

Remarques

Cette méthode est la définition abstraite d’une méthode administrative pour récupérer le nombre de données de personnalisation. Les implémentations dérivées doivent suivre la logique décrite ci-dessous.

Cette méthode transmet des caractères génériques de requête 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, vous pouvez effectuer une recherche générique sur un chemin d’accès partiel avec le caractère générique qui apparaît au début, à la fin ou au milieu du texte de la chaîne de recherche dans la PathToMatch propriété. Par exemple, pour rechercher tous les chemins qui commencent par « ~/vdir », la PathToMatch propriété est définie sur « ~/vdir% ».

De même, 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% ».

Les contraintes de requête suivantes s’appliquent :

  • Si est fourni uniquement scope et query est null ou toutes les propriétés sur query les valeurs retournées null ou par défaut, tous les enregistrements correspondant au paramètre indiqué scope sont comptés.

  • Si la PathToMatch propriété n’est pas null, les enregistrements comptabilisés sont également filtrés en fonction des chemins qui correspondent à la PathToMatch valeur.

  • Si la UsernameToMatch propriété n’est pas null, les enregistrements comptabilisés sont également filtrés en fonction des noms d’utilisateur qui correspondent à la valeur de la UsernameToMatch propriété.

  • Si la UserInactiveSinceDate propriété n’est pas égale à MaxValue, les enregistrements comptés sont également filtrés pour renvoyer uniquement les enregistrements associés aux utilisateurs inactifs. La comparaison inclut les enregistrements où la LastActivityDate propriété est inférieure ou égale à la UserInactiveSinceDate propriété .

Notez que cette méthode ne valide pas les combinaisons de paramètres de requête. Par exemple, le code peut demander un nombre d’enregistrements d’état de personnalisation associés à un nom d’utilisateur spécifique dans l’étendue partagée. Étant donné que les noms d’utilisateur ne sont pas associés aux informations partagées, le nombre retourné est égal à zéro.

Les combinaisons de paramètres qui ont le potentiel de retourner un nombre non nul sont les suivantes :

S’applique à