PersonalizationAdministration.FindSharedState Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca kolekcję udostępnionych informacji o stanie personalizacji na podstawie określonych parametrów.

Przeciążenia

FindSharedState(String)	Zwraca kolekcję udostępnionych informacji o stanie personalizacji na podstawie określonej ścieżki.
FindSharedState(String, Int32, Int32, Int32)	Zwraca kolekcję udostępnionych informacji o stanie personalizacji na podstawie określonych parametrów.

FindSharedState(String)

Zwraca kolekcję udostępnionych informacji o stanie personalizacji na podstawie określonej ścieżki.

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

Ścieżka strony do dopasowania.

Zwraca

PersonalizationStateInfoCollection

Element PersonalizationStateInfoCollection zawierający informacje o stanie współużytkowania personalizacji.

Wyjątki

ArgumentException

pathToMatch jest pustym ciągiem ("") przed lub po przycinaniu.

-lub-

Dostawca dostawcy personalizacji zdefiniowany w konfiguracji nie jest prawidłowym typem.

-lub-

Długość ciągu dowolnego parametru jest większa niż 256 znaków.

ConfigurationErrorsException

Wystąpił wyjątek konfiguracji podczas próby utworzenia i zainicjowania wystąpienia jednego ze skonfigurowanych dostawców personalizacji.

-lub-

Nie można odnaleźć domyślnego dostawcy personalizacji zdefiniowanego w konfiguracji.

Uwagi

Ta metoda zwraca kolekcję UserPersonalizationStateInfo wystąpień, w których pathToMatch wartość jest zgodna ze ścieżką strony zawierającej udostępnione dane stanu personalizacji. Kolekcja zawiera tylko SharedPersonalizationStateInfo wystąpienia.

Ta metoda przekazuje symbole wieloznaczne parametru do bazowego dostawcy personalizacji, więc sposób obsługi tych znaków przez magazyn danych zależy od sposobu obsługi znaków przez dostawcę, takich jak gwiazdka (*), symbol procentu (%), lub podkreślenie (_).

Zwykle w przypadku magazynów danych zgodnych z SQL można wykonać wyszukiwanie symboli wieloznacznych na częściowej ścieżce z symbolem wieloznacznymi wyświetlanym na początku, na końcu lub w środku tekstu ciągu wyszukiwania we PathToMatch właściwości . Aby na przykład znaleźć wszystkie ścieżki rozpoczynające się od ciągu "~/vdir", PathToMatch właściwość zostanie ustawiona na "~/vdir%".

Przy użyciu domyślnego dostawcy PersonalizationStateInfopersonalizacji obiekty pochodne są zwracane w kolejności alfabetycznej i sortowane według kombinacji ścieżki i nazwy użytkownika w kolejności rosnącej. Kolejność obiektów w kolekcji jest określana przez dostawcę.

Parametr pathToMatch może mieć wartość null. W przypadku ustawienia wartości nullparametr zostanie zignorowany podczas wykonywania zapytań.

Zobacz też

Dotyczy

FindSharedState(String, Int32, Int32, Int32)

Zwraca kolekcję udostępnionych informacji o stanie personalizacji na podstawie określonych parametrów.

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

Ścieżka strony do dopasowania.

pageIndex: Int32

Indeks zerowy strony wyników do zwrócenia.

pageSize: Int32

Liczba rekordów do zwrócenia.

totalRecords: Int32

Całkowita liczba dostępnych rekordów.

Zwraca

PersonalizationStateInfoCollection

Element PersonalizationStateInfoCollection zawierający informacje o stanie współużytkowania personalizacji.

Wyjątki

ArgumentException

pathToMatch przed lub po przycinaniu jest pusty ciąg ("").

-lub-

Parametr pageIndex ma wartość niższą niż zero.

-lub-

pageSize jest mniejsze niż lub równe zero.

-lub-

Kombinacja i pageIndex pageSize przekracza wartość Int32.MaxValue.

-lub-

Dostawca dostawcy personalizacji zdefiniowany w konfiguracji nie jest prawidłowym typem.

-lub-

Długość ciągu dowolnego parametru jest większa niż 256 znaków.

ConfigurationErrorsException

Wystąpił wyjątek konfiguracji podczas próby utworzenia i zainicjowania wystąpienia jednego ze skonfigurowanych dostawców personalizacji.

-lub-

Nie można odnaleźć domyślnego dostawcy personalizacji zdefiniowanego w konfiguracji.

Uwagi

Parametr pathToMatch może mieć wartość null. W przypadku ustawienia wartości nullparametr zostanie zignorowany podczas wykonywania zapytań.

Zwracane dane są ograniczone przez pageIndex elementy i pageSize, gdzie pageIndex kontrolki, które rekordy mają zwracać, i pageSize kontroluje liczbę rekordów do zwrócenia. Jeśli na przykład pageIndex ustawiono wartość 0 i pageSize została ustawiona na 25, zwrócone dane będą pierwszymi 25 wpisami. Jeśli pageIndex ustawiono wartość 1 i pageSize została ustawiona na 25, zwrócone dane będą zawierać wpisy od 26 do 50. Parametr totalRecords zwraca łączną liczbę dostępnych rekordów.

Zobacz też

Dotyczy