PersonalizationAdministration.ResetState 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.
Réinitialise les données de personnalisation dans le magasin de données sous-jacent, en fonction des éléments contenus dans la collection.
public:
static int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ data);
public static int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection data);
static member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection -> int
Public Shared Function ResetState (data As PersonalizationStateInfoCollection) As Integer
Paramètres
Une collection d’objets PersonalizationStateInfo indiquant les données à réinitialiser.
Retours
Nombre de lignes réinitialisées.
Exceptions
data
a la valeur null
.
data
est une collection vide.
- ou -
Un élément de la collection est null
.
- ou -
La valeur de chemin d’accès d’une instance UserPersonalizationStateInfo dans la collection est null
ou une chaîne vide (« »).
- ou -
La valeur user
de chemin d’accès d’une instance UserPersonalizationStateInfo dans la collection est null
, une chaîne vide ou contient des virgules.
- 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 indiqué que le nombre de lignes supprimées est un nombre négatif.
Remarques
Cette méthode réinitialise les données de personnalisation dans le magasin de données sous-jacent, en fonction des PersonalizationStateInfo objets contenus dans la collection. Vous pouvez utiliser cette méthode pour supprimer de manière sélective un mélange de données partagées et de données par utilisateur en fonction du contenu de la collection. SharedPersonalizationStateInfo les objets indiquent que les données partagées d’une page seront réinitialisées ; UserPersonalizationStateInfo les objets indiquent que les données par utilisateur d’une page spécifique seront réinitialisées.
Notes
Cette méthode ne garantit pas que toutes les réinitialisations se produisent au sein d’une seule transaction, car la collection pointe vers des jeux aléatoires de données de personnalisation.
Il ne s’agit pas d’une erreur pour que la collection contienne des objets qui référencent des données inexistantes.