PersonalizationProvider.ResetState Méthode

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

En cas de substitution dans une classe dérivée, supprime l’état de personnalisation du magasin de données sous-jacent en fonction des paramètres spécifiés.

public:
 abstract int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, cli::array <System::String ^> ^ paths, cli::array <System::String ^> ^ usernames);
public abstract int ResetState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, string[] paths, string[] usernames);
abstract member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationScope * string[] * string[] -> int
Public MustOverride Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer

Paramètres

scope
PersonalizationScope

Informations PersonalizationScope de personnalisation à réinitialiser. Cette valeur ne peut pas être null.

paths
String[]

Chemins d’accès aux informations de personnalisation à supprimer.

usernames
String[]

Noms d’utilisateur pour les informations de personnalisation à supprimer.

Retours

Int32

Nombre de lignes supprimées.

Remarques

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

Aucune recherche de caractères génériques n’est prise en charge par cette méthode. Si le fournisseur de personnalisation expose les données d’un magasin de données prenant en charge les transactions, cette méthode doit effectuer ses opérations en tant que transaction atomique unique.

Seules les combinaisons de paramètres suivantes sont autorisées :

  • Le scope paramètre est défini et tous les autres paramètres sont définis nullsur . Cette combinaison supprime toutes les données de personnalisation des composants WebPart associées à l’étendue de personnalisation indiquée par scope.

  • Le scope paramètre est défini et le paths paramètre contient au moins une valeur. Cette combinaison supprime toutes les données de personnalisation des composants WebPart pour le chemin d’accès ou les chemins spécifiés dans l’étendue de personnalisation indiquée par scope.

  • Le scope paramètre est défini sur , le User paramètre est défini pathset contient une seule valeur, et le usernames paramètre contient au moins une valeur. Cette combinaison supprime toutes les données de composants WebPart de personnalisation utilisateur pour le chemin d’accès donné associé à l’utilisateur ou aux utilisateurs contenus dans usernames.

  • Le scope paramètre est défini Usersur , le paths paramètre est défini nullsur , et le usernames paramètre contient au moins une valeur. Cette combinaison supprime toutes les données de composants WebPart de personnalisation par utilisateur, entre tous les chemins d’accès, associés à l’utilisateur ou aux utilisateurs contenus dans usernames.

Toute autre combinaison de valeurs de paramètre n’est pas valide et lève une ArgumentException exception. Plus précisément, les deux combinaisons suivantes ne sont pas autorisées :

  • Le usernames paramètre ne peut pas être fourni lorsqu’il scope est défini sur Shared.

  • Le paths paramètre ne peut pas contenir plusieurs entrées lorsque le usernames paramètre n’est pas null.

Toutes paths les valeurs de usernames paramètre contenues dans les tableaux respectifs doivent respecter les règles de validation suivantes. Si des règles de validation échouent pour un membre des tableaux de paramètres, une ArgumentException exception est levée. Les règles de validation sont les suivantes :

  • null les valeurs ne sont pas autorisées.

  • Une chaîne vide («  ») n’est pas autorisée. Les paramètres doivent être supprimés avant d’effectuer une vérification de chaîne vide.

  • Le usernames paramètre ne peut pas contenir de virgules (,).

  • La longueur du paths paramètre ne peut pas être supérieure à 256 caractères pour une base de données SQL.

  • La longueur du usernames paramètre ne peut pas être supérieure à 256 caractères pour une base de données SQL.

S’applique à