Sdílet prostřednictvím

PersonalizationAdministration.FindSharedState Metoda

  • Reference

Definice

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

Vrátí kolekci informací o stavu sdíleného přizpůsobení na základě zadaných parametrů.

Přetížení

FindSharedState(String)

Vrátí kolekci informací o stavu sdíleného přizpůsobení na základě zadané cesty.
FindSharedState(String, Int32, Int32, Int32)

Vrátí kolekci informací o stavu sdíleného přizpůsobení na základě zadaných parametrů.

FindSharedState(String)

Vrátí kolekci informací o stavu sdíleného přizpůsobení na základě zadané cesty.

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

Parametry

pathToMatch
String

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

Návraty

PersonalizationStateInfoCollection

A PersonalizationStateInfoCollection , který obsahuje informace o stavu sdíleného přizpůsobení.

Výjimky

ArgumentException

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

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

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, kde pathToMatch hodnota odpovídá cestě stránky, která má sdílená data o stavu přizpůsobení. Kolekce obsahuje pouze SharedPersonalizationStateInfo 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%.

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.

Parametrem pathToMatch může být null. Pokud je nastavená na null, parametr se při provádění dotazů ignoruje.

Viz také

Platí pro

FindSharedState(String, Int32, Int32, Int32)

Vrátí kolekci informací o stavu sdíleného přizpůsobení na základě zadaných parametrů.

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

Parametry

pathToMatch
String

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

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 sdíleného přizpůsobení.

Výjimky

ArgumentException

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

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, kde pathToMatch hodnota odpovídá cestě stránky, která má sdílená data o stavu přizpůsobení. Kolekce obsahuje pouze SharedPersonalizationStateInfo 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%.

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.

Parametrem pathToMatch může být null. Pokud je nastavená na null, parametr se při provádění dotazů ignoruje.

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