PersonalizationAdministration.FindInactiveUserState Metoda

  • Odwołanie

Definicja

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

Zwraca kolekcję informacji o stanie personalizacji dla użytkowników nieaktywnych na podstawie określonych parametrów.

Przeciążenia

FindInactiveUserState(String, String, DateTime)

Zwraca kolekcję informacji o stanie personalizacji dla użytkowników nieaktywnych na podstawie określonych parametrów.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Zwraca kolekcję informacji o stanie personalizacji dla użytkowników nieaktywnych na podstawie określonych parametrów.

FindInactiveUserState(String, String, DateTime)

Zwraca kolekcję informacji o stanie personalizacji dla użytkowników nieaktywnych na podstawie określonych parametrów.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);
static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection

Parametry

pathToMatch
String

Ścieżka strony do dopasowania.

usernameToMatch
String

Nazwa użytkownika zgodna z danymi personalizacji skojarzonymi ze stroną.

userInactiveSinceDate
DateTime

Ostatnia data uzyskania dostępu do informacji o personalizacji użytkownika.

Zwraca

PersonalizationStateInfoCollection

Element PersonalizationStateInfoCollection zawierający informacje o stanie personalizacji poszczególnych użytkowników.

Wyjątki

ArgumentException

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

-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ń, informacje o stanie personalizacji poszczególnych użytkowników, w których pathToMatch wartość parametru jest zgodna ze ścieżką strony, usernameToMatch pasuje do nazwy użytkownika, która zawiera dane personalizacji skojarzone z tą stroną, a użytkownicy są traktowani jako nieaktywni. Innymi słowy, dla każdego zwróconego rekordu wartość właściwości użytkownika LastActivityDate jest mniejsza lub równa userInactiveSinceDate. Zwrócona kolekcja zawiera tylko UserPersonalizationStateInfo wystąpienia.

Ta metoda przekazuje symbole wieloznaczne zapytania do bazowego magazynu danych. Obsługa symboli wieloznacznych jest obecnie zależna od sposobu obsługi znaków przez każdego 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%".

Podobnie wyszukiwanie symboli wieloznacznych w częściowej nazwie użytkownika może mieć symbol wieloznaczny wyświetlany w dowolnym momencie w ciągu tekstowym UsernameToMatch właściwości. Aby na przykład znaleźć wszystkie nazwy użytkowników rozpoczynające się od "John", UsernameToMatch właściwość będzie wyglądać następująco: "John%".

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

Jeśli userInactiveSinceDate parametr ma MaxValuewartość , zwracane wartości z tej metody są równoważne .FindUserState

Oba pathToMatch elementy i usernameToMatch mogą mieć wartość null. Parametr usernameToMatch może zawierać przecinki (,), ponieważ niektóre magazyny danych, takie jak te z systemem Microsoft SQL Server, zezwalają na przecinki jako znaki wieloznaczne.

Zobacz też

Dotyczy

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Zwraca kolekcję informacji o stanie personalizacji dla użytkowników nieaktywnych na podstawie określonych parametrów.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);
static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametry

pathToMatch
String

Ścieżka strony do dopasowania.

usernameToMatch
String

Nazwa użytkownika zgodna z danymi personalizacji skojarzonymi ze stroną.

userInactiveSinceDate
DateTime

Uzyskiwano dostęp do informacji o ostatniej dacie personalizacji.

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 personalizacji poszczególnych użytkowników.

Wyjątki

ArgumentException

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

-lub-

pageIndex jest mniejsza niż zero

-lub-

pageSize jest mniejsze niż lub równe zero.

-lub-

kombinacja parametrów pageIndex i 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

Ta metoda zwraca kolekcję UserPersonalizationStateInfo wystąpień, informacje o stanie personalizacji poszczególnych użytkowników, w których pathToMatch wartość parametru jest zgodna ze ścieżką strony, usernameToMatch pasuje do nazwy użytkownika, która zawiera dane personalizacji skojarzone z tą stroną, a użytkownicy są traktowani jako nieaktywni. Innymi słowy, dla każdego zwróconego rekordu wartość właściwości użytkownika LastActivityDate jest mniejsza lub równa userInactiveSinceDate. Kolekcja zawiera tylko UserPersonalizationStateInfo 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%".

Podobnie wyszukiwanie symboli wieloznacznych w częściowej nazwie użytkownika może mieć symbol wieloznaczny wyświetlany w dowolnym momencie w ciągu tekstowym UsernameToMatch właściwości. Aby na przykład znaleźć wszystkie nazwy użytkowników rozpoczynające się od "John", UsernameToMatch właściwość będzie wyglądać następująco: "John%".

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

Jeśli userInactiveSinceDate parametr ma MaxValuewartość , zwracane wartości z tej metody są równoważne .FindUserState

Oba pathToMatch elementy i usernameToMatch mogą mieć wartość null. Parametr usernameToMatch może zawierać przecinki (,), ponieważ niektóre magazyny danych, takie jak te z systemem Microsoft SQL Server, zezwalają na przecinki jako znaki wieloznaczne.

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