Partager via


PersonalizationAdministration.FindSharedState Méthode

Définition

Retourne une collection d'informations partagées d'état de personnalisation, selon les paramètres spécifiés.

Surcharges

FindSharedState(String)

Retourne une collection d'informations d'état de personnalisation partagées, selon le chemin spécifié.

FindSharedState(String, Int32, Int32, Int32)

Retourne une collection d'informations partagées d'état de personnalisation, selon les paramètres spécifiés.

FindSharedState(String)

Retourne une collection d'informations d'état de personnalisation partagées, selon le chemin spécifié.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch);
static member FindSharedState : string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String) As PersonalizationStateInfoCollection

Paramètres

pathToMatch
String

Chemin d'accès de la page à faire correspondre.

Retours

PersonalizationStateInfoCollection qui contient des informations d'état de personnalisation partagées.

Exceptions

pathToMatch est une chaîne vide (""), avant ou après rognage.

- 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.

Remarques

Cette méthode retourne une collection d’instances UserPersonalizationStateInfo dont la pathToMatch valeur correspond au chemin d’accès d’une page qui contient des données d’état de personnalisation partagées. La collection contient uniquement SharedPersonalizationStateInfo des instances.

Cette méthode transmet les caractères génériques de paramètre au fournisseur de personnalisation sous-jacent. La façon dont le magasin de données gère ces caractères dépend donc de la façon dont le fournisseur gère les caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

Normalement, pour les magasins de données conformes à SQL, vous pouvez effectuer une recherche par caractères génériques sur un chemin d’accès partiel avec le caractère générique apparaissant au début, à la fin ou au milieu du texte de 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% ».

À l’aide du fournisseur de personnalisation par défaut, les PersonalizationStateInfoobjets dérivés sont retournés par ordre alphabétique et triés par une combinaison de chemin d’accès et de nom d’utilisateur dans l’ordre croissant. L’ordre des objets dans la collection est déterminé par le fournisseur.

Le pathToMatch paramètre peut être null. Si la valeur nullest définie sur , le paramètre est ignoré lors de l’exécution de requêtes.

Voir aussi

S’applique à

FindSharedState(String, Int32, Int32, Int32)

Retourne une collection d'informations partagées d'état de personnalisation, selon les paramètres spécifiés.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindSharedState : string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Paramètres

pathToMatch
String

Chemin d'accès de la page à faire correspondre.

pageIndex
Int32

Index de base zéro de la page de résultats à retourner.

pageSize
Int32

Nombre d'enregistrements à retourner.

totalRecords
Int32

Nombre total d'enregistrements disponibles.

Retours

PersonalizationStateInfoCollection qui contient des informations d'état de personnalisation partagées.

Exceptions

pathToMatch avant ou après troncature est une chaîne vide ("").

- ou -

pageIndex est inférieur à zéro.

- ou -

pageSize est inférieur ou égal à zéro.

-ou-

La combinaison de pageIndex et pageSize dépasse Int32.MaxValue.

- 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.

Remarques

Cette méthode retourne une collection d’instances UserPersonalizationStateInfo dont la pathToMatch valeur correspond au chemin d’accès d’une page qui contient des données d’état de personnalisation partagées. La collection contient uniquement SharedPersonalizationStateInfo des instances.

Cette méthode transmet les caractères génériques de paramètre au fournisseur de personnalisation sous-jacent. La façon dont le magasin de données gère ces caractères dépend donc de la façon dont le fournisseur gère les caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

Normalement, pour les magasins de données conformes à SQL, vous pouvez effectuer une recherche par caractères génériques sur un chemin d’accès partiel avec le caractère générique apparaissant au début, à la fin ou au milieu du texte de 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% ».

À l’aide du fournisseur de personnalisation par défaut, les PersonalizationStateInfoobjets dérivés sont retournés par ordre alphabétique et triés par une combinaison de chemin d’accès et de nom d’utilisateur dans l’ordre croissant. L’ordre des objets de la collection est déterminé par le fournisseur.

Le pathToMatch paramètre peut être null. Si la valeur nullest définie sur , le paramètre est ignoré lors de l’exécution de requêtes.

Les données retournées sont limitées par pageIndex et , où pageIndex contrôle les enregistrements à retourner et pageSize contrôle le nombre d’enregistrements pageSizeà retourner. Par exemple, si pageIndex a été défini sur 0 et pageSize a été défini sur 25, les données retournées seraient les 25 premières entrées. Si pageIndex a la valeur 1 et pageSize a la valeur 25, les données retournées sont les entrées 26 à 50. Le totalRecords paramètre retourne le nombre total d’enregistrements disponibles.

Voir aussi

S’applique à