Partager via


PersonalizationAdministration.FindUserState Méthode

Définition

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

Surcharges

FindUserState(String, String)

Retourne une collection d'informations d'état de personnalisation par utilisateur, selon le nom d'utilisateur et le chemin vers la page.

FindUserState(String, String, Int32, Int32, Int32)

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

FindUserState(String, String)

Retourne une collection d'informations d'état de personnalisation par utilisateur, selon le nom d'utilisateur et le chemin vers la page.

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

Paramètres

pathToMatch
String

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

usernameToMatch
String

Nom d'utilisateur à faire correspondre et ayant les données de personnalisation associées à la page.

Retours

PersonalizationStateInfoCollection qui contient les informations d'état de personnalisation par utilisateur.

Exceptions

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

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

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode FindUserState. L’exemple complet se trouve dans la rubrique vue d’ensemble de la PersonalizationAdministration classe.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

Remarques

Cette méthode retourne une collection d’instances où la valeur du UserPersonalizationStateInfopathToMatch paramètre correspond au chemin d’accès d’une page et usernameToMatch correspond à un nom d’utilisateur qui a des données de personnalisation associées à cette page. La collection contient uniquement UserPersonalizationStateInfo des instances.

Cette méthode transmet des 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 des caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

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

De même, une recherche générique sur un nom d’utilisateur partiel peut faire apparaître le caractère générique à n’importe quel point de la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur qui commencent par « John », la UsernameToMatch propriété ressemblerait à « John% ».

À l’aide du fournisseur de personnalisation par défaut, les PersonalizationStateInfoobjets dérivés sont retournés dans l’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.

usernameToMatch Et pathToMatch peuvent être null. Le usernameToMatch paramètre peut avoir des virgules (,), car certains magasins de données, tels que ceux exécutant Microsoft SQL Server, autorisent les virgules en tant que caractères génériques.

Voir aussi

S’applique à

FindUserState(String, String, Int32, Int32, Int32)

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

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindUserState (pathToMatch As String, usernameToMatch 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.

usernameToMatch
String

Nom d'utilisateur à faire correspondre et ayant les données de personnalisation associées à la page.

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 les informations d'état de personnalisation par utilisateur.

Exceptions

pathToMatch ou usernameToMatch 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.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode FindUserState. L’exemple complet se trouve dans la rubrique vue d’ensemble de la PersonalizationAdministration classe.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

Remarques

Cette méthode retourne une collection d’instances où la valeur du UserPersonalizationStateInfopathToMatch paramètre correspond au chemin d’accès d’une page et usernameToMatch correspond à un nom d’utilisateur qui a des données de personnalisation associées à cette page. La collection contient uniquement UserPersonalizationStateInfo des instances.

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

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

De même, une recherche générique sur un nom d’utilisateur partiel peut faire apparaître le caractère générique à n’importe quel point de la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur qui commencent par « John », la UsernameToMatch propriété ressemblerait à « John% ».

À l’aide du fournisseur de personnalisation par défaut, les PersonalizationStateInfoobjets dérivés sont retournés dans l’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.

usernameToMatch Et pathToMatch peuvent être null. Le usernameToMatch paramètre peut avoir des virgules (,), car certains magasins de données, tels que ceux exécutant Microsoft SQL Server, autorisent les virgules en tant que caractères génériques.

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 sont 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 à