PersonalizationAdministration.FindSharedState Metoda

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í

Name Description
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 sdíleném stavu přizpůsobení.

Výjimky

ArgumentException

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

nebo

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

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ího zprostředkovatele přizpůsobení definovaného v konfiguraci nelze najít.

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, kde pathToMatch hodnota odpovídá cestě stránky, která má sdílená data stavu přizpůsobení. Kolekce obsahuje pouze SharedPersonalizationStateInfo instance.

Tato metoda předá zástupným znakům parametru podkladové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 je hvězdička (*), symbol procenta (%) nebo podtržítko (_).

V případě úložišť dat kompatibilních s SQL můžete obvykle provést vyhledávání se zástupnými znaky na částečné cestě se zástupnými znaky, které se zobrazí na začátku, na konci nebo uprostřed textu vyhledávacího řetězce ve PathToMatch vlastnosti. Chcete-li například 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í se vrátí odvozené objekty v abecedním pořadí a seřadí se podle kombinace cesty a uživatelského jména ve vzestupném pořadí. Pořadí objektů v kolekci určuje zprostředkovatel.

Parametr pathToMatch může být null. Pokud je nastavená hodnota 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ů založený na nule, který se má vrátit.

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 sdíleném stavu 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řekročení hodnoty Int32.MaxValue.

nebo

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

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ího zprostředkovatele přizpůsobení definovaného v konfiguraci nelze najít.

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, kde pathToMatch hodnota odpovídá cestě stránky, která má sdílená data stavu přizpůsobení. Kolekce obsahuje pouze SharedPersonalizationStateInfo instance.

Tato metoda předá zástupným znakům parametru podkladové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 je hvězdička (*), symbol procenta (%) nebo podtržítko (_).

V případě úložišť dat kompatibilních s SQL můžete obvykle provést vyhledávání se zástupnými znaky na částečné cestě se zástupnými znaky, které se zobrazí na začátku, na konci nebo uprostřed textu vyhledávacího řetězce ve PathToMatch vlastnosti. Chcete-li například 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í se vrátí odvozené objekty v abecedním pořadí a seřadí se podle kombinace cesty a uživatelského jména ve vzestupném pořadí. Pořadí objektů v kolekci určuje poskytovatel.

Parametr pathToMatch může být null. Pokud je nastavená hodnota 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 byla například nastavena na hodnotu 0 a pageSize byla nastavena na hodnotu 25, vrácená data by byla prvních 25 položek. Pokud pageIndex byla nastavena na hodnotu 1 a pageSize byla nastavena na 25, vrácená data by byla položkami 26 až 50. Parametr totalRecords vrátí celkový počet dostupných záznamů.

Viz také

Platí pro