Udostępnij przez

PersonalizationAdministration.FindSharedState Metoda

  • Odwołanie

Definicja

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

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

Przeciążenia

FindSharedState(String)

Zwraca kolekcję informacji o stanie personalizacji udostępnionej 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ę informacji o stanie personalizacji udostępnionej 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 udostępnionej personalizacji.

Wyjątki

ArgumentException

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

-lub-

Dostawca dostawcy personalizacji zdefiniowanego w konfiguracji nie jest poprawnym 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, która ma 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 tego, jak dostawca obsługuje znaki, takie jak gwiazdka (*), symbol procentu (%), lub podkreślenie (_).

Zwykle w przypadku magazynów danych zgodnych z programem SQL można wykonać wyszukiwanie symboli wieloznacznych na ścieżce częściowej 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 posortowane 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. Jeśli ustawiono nullwartość , parametr jest ignorowany 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

Łączna liczba dostępnych rekordów.

Zwraca

PersonalizationStateInfoCollection

Element PersonalizationStateInfoCollection zawierający informacje o stanie udostępnionej personalizacji.

Wyjątki

ArgumentException

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

-lub-

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

-lub-

pageSize wartość jest mniejsza niż lub równa zero.

-lub-

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

-lub-

Dostawca dostawcy personalizacji zdefiniowanego w konfiguracji nie jest poprawnym 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, która ma 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 tego, jak dostawca obsługuje znaki, takie jak gwiazdka (*), symbol procentu (%), lub podkreślenie (_).

Zwykle w przypadku magazynów danych zgodnych z programem SQL można wykonać wyszukiwanie symboli wieloznacznych na ścieżce częściowej 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 posortowane 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. Jeśli ustawiono nullwartość , parametr jest ignorowany podczas wykonywania zapytań.

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

Zobacz też

Dotyczy