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 issu du magasin de données sous-jacent selon les 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

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

paths

String[]

Chemins d'accès pour les informations de personnalisation à supprimer.

usernames

String[]

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

Retours

Int32

Nombre de lignes à supprimer.

Remarques

Cette méthode est la définition abstraite d’une méthode administrative pour la suppression de 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 personnalisations expose des données à partir d’un magasin de données prenant en charge les transactions, cette méthode doit exécuter 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 ont la valeur null . cette combinaison supprime toutes les composants WebPart données de personnalisation associées à la portée 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 composants WebPart données de personnalisation pour le ou les chemins d’accès spécifiés dans la portée de personnalisation indiquée par scope .

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

• Le paramètre scope a la valeur User , le paths paramètre a la valeur null , et le usernames paramètre contient au moins une valeur. cette combinaison supprime toutes les données de personnalisation composants WebPart par utilisateur, sur tous les chemins d’accès, associées à l’utilisateur ou aux utilisateurs contenus dans usernames .

Toute autre combinaison de valeurs de paramètre n’est pas valide et lèvera 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 lorsque scope a la valeur Shared .

• Le paths paramètre ne peut pas contenir plus d’une entrée lorsque le usernames paramètre n’est pas null .

Toutes paths les usernames valeurs de paramètre et 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.