PersonalizationAdministration.FindInactiveUserState Метод

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Возвращает коллекцию информации состояния персонализации "на пользователя" для неактивных пользователей на основе указанных параметров.

Перегрузки

FindInactiveUserState(String, String, DateTime)	Возвращает коллекцию информации состояния персонализации "на пользователя" для неактивных пользователей на основе указанных параметров.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	Возвращает коллекцию информации состояния персонализации "на пользователя" для неактивных пользователей на основе указанных параметров.

FindInactiveUserState(String, String, DateTime)

Возвращает коллекцию информации состояния персонализации "на пользователя" для неактивных пользователей на основе указанных параметров.

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

Параметры

pathToMatch

String

Путь к странице для сопоставления.

usernameToMatch

String

Имя пользователя для сопоставления, имеющее данные персонализации, связанные с данной страницей.

userInactiveSinceDate

DateTime

Дата последнего обращения к информации персонализации пользователя.

Возвращаемое значение

PersonalizationStateInfoCollection

Объект PersonalizationStateInfoCollection, содержащий сведения о состоянии персонализации "на пользователя".

Исключения

ArgumentException

Параметр pathToMatch или usernameToMatch перед или после усечения представляет собой пустую строку ("").

-или-

Поставщик, указанный в конфигурации в качестве поставщика персонализации, имеет неправильный тип.

-или-

Длина строки для любого параметра превышает 256 символов.

ConfigurationErrorsException

При попытке создания и инициализации нового экземпляра одного из настроенных поставщиков персонализации получено исключение конфигурации.

-или-

Не удалось найти поставщик персонализации по умолчанию (определяется в конфигурации).

Комментарии

Этот метод возвращает коллекцию UserPersonalizationStateInfo экземпляров, сведения о состоянии персонализации каждого пользователя, где pathToMatch значение параметра соответствует пути к странице, совпадает с именем пользователя с usernameToMatch данными персонализации, связанными с этой страницей, и пользователи считаются неактивными. Другими словами, для каждой возвращаемой записи значение свойства пользователя LastActivityDate меньше или равно userInactiveSinceDate. Возвращаемая коллекция содержит только UserPersonalizationStateInfo экземпляры.

Этот метод передает подстановочные знаки запроса в базовое хранилище данных. Поддержка подстановочных знаков в настоящее время зависит от того, как каждый поставщик обрабатывает такие символы, как звездочка (*), символ процента (%) или символ подчеркивания (_).

Обычно для хранилищ данных, совместимых с SQL, можно выполнить поиск с подстановочными знаками по частичному пути с подстановочным знаком, отображаемым в начале, конце или середине текста строки поиска в свойстве PathToMatch . Например, чтобы найти все пути, начинающиеся с "~/vdir", свойству PathToMatch будет присвоено значение "~/vdir%".

Аналогичным образом, при поиске с подстановочными знаками по частичному имени пользователя подстановочный знак может отображаться в любой точке текстовой UsernameToMatch строки свойства. Например, чтобы найти все имена пользователей, начинающиеся с "John", UsernameToMatch свойство будет выглядеть как "John%".

С помощью поставщика PersonalizationStateInfoперсонализации по умолчанию производные объекты возвращаются в алфавитном порядке и сортируются по сочетанию пути и имени пользователя в порядке возрастания. Порядок объектов в коллекции определяется поставщиком.

Если userInactiveSinceDate имеет значение MaxValue, то значения, возвращаемые этим методом FindUserState, эквивалентны .

И pathToMatch могут usernameToMatch иметь значение null. Параметр usernameToMatch может включать запятые (,), так как в некоторых хранилищах данных, таких как Microsoft SQL Server, запятые допускаются в качестве подстановочных знаков.

См. также раздел

• WebPartPersonalization
• элементы управления веб-частей ASP.NET
• Обзор персонализации веб-частей
• Пошаговое руководство. Реализация персонализации веб-частей с помощью пользовательского элемента управления
• Персонализация веб-частей

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

Возвращает коллекцию информации состояния персонализации "на пользователя" для неактивных пользователей на основе указанных параметров.

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

Параметры

pathToMatch

String

Путь к странице для сопоставления.

usernameToMatch

String

Имя пользователя для сопоставления, имеющее данные персонализации, связанные с данной страницей.

userInactiveSinceDate

DateTime

Дата последнего обращения к данным персонализации.

pageIndex

Int32

Отсчет индекса возвращаемой страницы результатов начинается с нуля.

pageSize

Int32

Число возвращаемых записей.

totalRecords

Int32

Общее число доступных записей.

Возвращаемое значение

PersonalizationStateInfoCollection

Объект PersonalizationStateInfoCollection, содержащий сведения о состоянии персонализации "на пользователя".

Исключения

ArgumentException

Параметр pathToMatch или usernameToMatch перед или после усечения представляет собой пустую строку ("").

-или-

Значение параметра pageIndex меньше нуля.

-или-

pageSize меньше или равно нулю.

-или-

сочетание pageIndex и pageSize превышает Значение Int32.MaxValue.

-или-

Поставщик, указанный в конфигурации в качестве поставщика персонализации, имеет неправильный тип.

-или-

Длина строки для любого параметра превышает 256 символов.

ConfigurationErrorsException

При попытке создания и инициализации нового экземпляра одного из настроенных поставщиков персонализации получено исключение конфигурации.

-или-

Не удалось найти поставщик персонализации по умолчанию (определяется в конфигурации).

Комментарии

Этот метод возвращает коллекцию UserPersonalizationStateInfo экземпляров, сведения о состоянии персонализации каждого пользователя, где pathToMatch значение параметра соответствует пути к странице, совпадает с именем пользователя с usernameToMatch данными персонализации, связанными с этой страницей, и пользователи считаются неактивными. Другими словами, для каждой возвращаемой записи значение свойства пользователя LastActivityDate меньше или равно userInactiveSinceDate. Коллекция содержит только UserPersonalizationStateInfo экземпляры.

Этот метод передает подстановочные знаки параметров базовому поставщику персонализации, поэтому способ обработки этих символов в хранилище данных зависит от того, как поставщик обрабатывает символы, такие как звездочка (*), символ процента (%) или символ подчеркивания (_).

Обычно для хранилищ данных, совместимых с SQL, можно выполнить поиск с подстановочными знаками по частичному пути с подстановочным знаком, отображаемым в начале, конце или середине текста строки поиска в свойстве PathToMatch . Например, чтобы найти все пути, начинающиеся с "~/vdir", свойству PathToMatch будет присвоено значение "~/vdir%".

Аналогичным образом, при поиске с подстановочными знаками по частичному имени пользователя подстановочный знак может отображаться в любой точке текстовой UsernameToMatch строки свойства. Например, чтобы найти все имена пользователей, начинающиеся с "John", UsernameToMatch свойство будет выглядеть как "John%".

С помощью поставщика PersonalizationStateInfoперсонализации по умолчанию производные объекты возвращаются в алфавитном порядке и сортируются по сочетанию пути и имени пользователя в порядке возрастания. Порядок объектов в коллекции определяется поставщиком.

Если userInactiveSinceDate имеет значение MaxValue, то значения, возвращаемые этим методом FindUserState, эквивалентны .

И pathToMatch могут usernameToMatch иметь значение null. Параметр usernameToMatch может содержать запятые (,), так как в некоторых хранилищах данных, таких как microsoft SQL Server, запятые допускаются как подстановочные знаки.

Возвращаемые данные ограничиваются pageIndex и pageSize, где pageIndex определяет, какие записи следует возвращать, а pageSize также количество возвращаемых записей. Например, если pageIndex задано значение 0, а pageSize значение 25, то возвращаемые данные будут первыми 25 записями. Если pageIndex задано значение 1, а pageSize значение 25, то возвращаемые данные будут записями с 26 по 50. Параметр totalRecords возвращает общее количество доступных записей.

См. также раздел

• WebPartPersonalization
• элементы управления веб-частей ASP.NET
• Обзор персонализации веб-частей
• Пошаговое руководство. Реализация персонализации веб-частей с помощью пользовательского элемента управления
• Персонализация веб-частей