Sdílet prostřednictvím

PersonalizationAdministration.FindUserState Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů na základě zadaných parametrů.

Přetížení

FindUserState(String, String)

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů na základě uživatelského jména a cesty ke stránce.
FindUserState(String, String, Int32, Int32, Int32)

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů na základě zadaných parametrů.

FindUserState(String, String)

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů na základě uživatelského jména a cesty ke stránce.

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

Parametry

pathToMatch
String

Cesta stránky, která se má shodovat.

usernameToMatch
String

Uživatelské jméno, které se má shodovat s daty přizpůsobení přidružené ke stránce.

Návraty

PersonalizationStateInfoCollection

A PersonalizationStateInfoCollection , který obsahuje informace o stavu přizpůsobení jednotlivých uživatelů.

Výjimky

ArgumentException

pathToMatch nebo usernameToMatch před nebo po oříznutí je prázdný řetězec ("").

-nebo-

Zprostředkovatel pro zprostředkovatele přizpůsobení definovaný v konfiguraci není správného typu.

-nebo-

Délka řetězce libovolného parametru je větší než 256 znaků.

ConfigurationErrorsException

Při pokusu o vytvoření a inicializaci instance jednoho z nakonfigurovaných zprostředkovatelů přizpůsobení došlo k výjimce konfigurace.

-nebo-

Výchozí zprostředkovatel přizpůsobení definovaný v konfiguraci nebyl nalezen.

Příklady

Následující příklad kódu ukazuje, jak použít metodu FindUserState . Úplný příklad najdete v tématu s přehledem PersonalizationAdministration třídy.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

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.";
  }

}

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, kde hodnota parametru pathToMatch odpovídá cestě stránky a usernameToMatch odpovídá uživatelskému jménu, které má data přizpůsobení přidružená k dané stránce. Kolekce obsahuje pouze UserPersonalizationStateInfo instance.

Tato metoda předává zástupné znaky parametrů základnímu zprostředkovateli přizpůsobení, takže způsob, jakým úložiště dat tyto znaky zpracovává, závisí na tom, jak zprostředkovatel zpracovává znaky, jako je hvězdička (*), symbol procenta (%) nebo podtržítko (_).

Za normálních okolností můžete u úložišť dat kompatibilních s SQL provádět vyhledávání pomocí zástupných znaků na částečné cestě se zástupným znakem zobrazeným na začátku, konci nebo uprostřed textu hledaného řetězce ve PathToMatch vlastnosti. Pokud například chcete najít všechny cesty začínající na ~/vdir, PathToMatch vlastnost by byla nastavena na ~/vdir%.

Podobně vyhledávání se zástupnými znaky u částečného uživatelského jména může mít v libovolném bodě v textovém řetězci UsernameToMatch vlastnosti zástupný znak. Pokud například chcete najít všechna uživatelská jména začínající na "John", UsernameToMatch bude vlastnost vypadat takto: "John%".

Pomocí výchozího zprostředkovatele PersonalizationStateInfopřizpůsobení jsou objekty odvozené od -vráceny v abecedním pořadí a seřazeny podle kombinace cesty a uživatelského jména ve vzestupném pořadí. Pořadí objektů v kolekci je určeno poskytovatelem.

Obě a pathToMatchusernameToMatch mohou být null. Parametr usernameToMatch může obsahovat čárky (,), protože některá úložiště dat, například ta, na kterých běží Microsoft SQL Server, povolují čárky jako zástupné znaky.

Viz také

Platí pro

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

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů na základě zadaných parametrů.

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

Parametry

pathToMatch
String

Cesta stránky, která se má shodovat.

usernameToMatch
String

Uživatelské jméno, které se má shodovat s daty přizpůsobení přidružené ke stránce.

pageIndex
Int32

Index stránky výsledků, který se má vrátit na základě nuly.

pageSize
Int32

Počet záznamů, které se mají vrátit.

totalRecords
Int32

Celkový počet dostupných záznamů.

Návraty

PersonalizationStateInfoCollection

A PersonalizationStateInfoCollection , který obsahuje informace o stavu přizpůsobení jednotlivých uživatelů.

Výjimky

ArgumentException

pathToMatch nebo usernameToMatch před nebo po oříznutí je prázdný řetězec ("").

-nebo-

Hodnota pageIndex je menší než nula.

-nebo-

pageSize je menší než nebo rovno nule.

-nebo-

Kombinace pageIndex a pageSize překračuje Int32.MaxValue.

-nebo-

Zprostředkovatel pro zprostředkovatele přizpůsobení definovaný v konfiguraci není správného typu.

-nebo-

Délka řetězce libovolného parametru je větší než 256 znaků.

ConfigurationErrorsException

Při pokusu o vytvoření a inicializaci instance jednoho z nakonfigurovaných zprostředkovatelů přizpůsobení došlo k výjimce konfigurace.

-nebo-

Výchozí zprostředkovatel přizpůsobení definovaný v konfiguraci nebyl nalezen.

Příklady

Následující příklad kódu ukazuje, jak použít metodu FindUserState . Úplný příklad najdete v tématu s přehledem PersonalizationAdministration třídy.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

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.";
  }

}

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, kde hodnota parametru pathToMatch odpovídá cestě stránky a usernameToMatch odpovídá uživatelskému jménu, které má data přizpůsobení přidružená k dané stránce. Kolekce obsahuje pouze UserPersonalizationStateInfo instance.

Tato metoda předává zástupné znaky parametrů základnímu zprostředkovateli přizpůsobení, takže způsob, jakým úložiště dat zpracovává tyto znaky, závisí na tom, jak zprostředkovatel zpracovává znaky jako hvězdička (*), symbol procenta (%) nebo podtržítko (_).

Za normálních okolností můžete u úložišť dat kompatibilních s SQL provádět vyhledávání pomocí zástupných znaků na částečné cestě se zástupným znakem zobrazeným na začátku, konci nebo uprostřed textu hledaného řetězce ve PathToMatch vlastnosti. Pokud například chcete najít všechny cesty začínající na ~/vdir, PathToMatch vlastnost by byla nastavena na ~/vdir%.

Podobně vyhledávání se zástupnými znaky u částečného uživatelského jména může mít v libovolném bodě v textovém řetězci UsernameToMatch vlastnosti zástupný znak. Pokud například chcete najít všechna uživatelská jména začínající na "John", UsernameToMatch bude vlastnost vypadat takto: "John%".

Pomocí výchozího zprostředkovatele PersonalizationStateInfopřizpůsobení jsou objekty odvozené od -vráceny v abecedním pořadí a seřazeny podle kombinace cesty a uživatelského jména ve vzestupném pořadí. Pořadí objektů v kolekci určuje poskytovatel.

Obě a pathToMatchusernameToMatch mohou být null. Parametr usernameToMatch může obsahovat čárky (,), protože některá úložiště dat, například ta, na kterých běží Microsoft SQL Server, povolují čárky jako zástupné znaky.

Vrácená data jsou omezena pageIndex a pageSize, kde pageIndex určuje, které záznamy se mají vrátit, a pageSize řídí počet záznamů, které se mají vrátit. Pokud pageIndex by například byla nastavena hodnota 0 a pageSize byla nastavena na hodnotu 25, vrácená data by byla prvních 25 položek. Pokud pageIndex byla nastavena hodnota 1 a pageSize byla nastavena na hodnotu 25, vrácená data by byla položky 26 až 50. Parametr totalRecords vrátí celkový počet dostupných záznamů.

Viz také

Platí pro