SqlPersonalizationProvider.ResetState Méthode

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Supprime des informations d'état de personnalisation dans le magasin de données sous-jacent, selon les paramètres spécifiés.

public:
 override int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, cli::array <System::String ^> ^ paths, cli::array <System::String ^> ^ usernames);

public override int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, string[] paths, string[] usernames);

override this.ResetState : System.Web.UI.WebControls.WebParts.PersonalizationScope * string[] * string[] -> int

Public Overrides Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer

Paramètres

scope

PersonalizationScope

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

paths

String[]

Chemins d'accès aux informations de personnalisation dans la portée Shared à supprimer.

usernames

String[]

Noms d'utilisateur destinés aux informations de personnalisation dans la portée User à supprimer.

Retours

Int32

Nombre de lignes à supprimer.

Exceptions

ArgumentException

Le paths ou usernames est un tableau vide.

• ou - Les paths et usernames présents dans les tableaux respectifs ne satisfont pas les règles de validation.

ArgumentOutOfRangeException

Le scope spécifié n'est pas membre de l'énumération PersonalizationScope.

Remarques

Aucun caractère générique n’est pris en charge par cette méthode.

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 de 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 de composants WebPart pour le chemin d’accès ou les chemins spécifiés qui se trouvent dans l’étendue de personnalisation indiquée par scope.

• Le scope paramètre est défini Usersur , le paths paramètre est défini et contient un seul chemin 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 nullet le usernames paramètre contient au moins une valeur. Cette combinaison supprime toutes les données de composants WebPart de personnalisation par utilisateur, sur 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. Par exemple, les deux combinaisons suivantes ne sont pas autorisées :

• Le usernames paramètre ne peut pas être fourni lorsque le scope paramètre est défini Sharedsur .

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

Les paths paramètres et usernames les paramètres contenus 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 («  ») une fois la chaîne supprimée n’est pas autorisée.

• Aucun nom d’utilisateur contenu dans le usernames paramètre ne peut contenir de virgules.

• La longueur d’un chemin d’accès dans le paths paramètre ne peut pas dépasser 256 caractères.

• La longueur d’un nom d’utilisateur dans le usernames paramètre ne peut pas dépasser 256 caractères.