PersonalizationAdministration.FindInactiveUserState Método

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

Parámetros

Devoluciones

Clase PersonalizationStateInfoCollection que contiene la información de estado de personalización por usuario.

Excepciones

Comentarios

Este método devuelve una colección de instancias, información de estado de UserPersonalizationStateInfo personalización por usuario donde el valor del pathToMatch parámetro coincide con la ruta de acceso de una página, usernameToMatch coincide con un nombre de usuario que tiene datos de personalización asociados a esa página y los usuarios se consideran inactivos. Es decir, para cada registro devuelto, el valor de propiedad del LastActivityDate usuario es menor o igual que userInactiveSinceDate. La colección devuelta solo UserPersonalizationStateInfo contiene instancias.

Este método pasa caracteres comodín de consulta al almacén de datos subyacente. La compatibilidad con caracteres comodín depende actualmente de cómo controla cada proveedor caracteres, como un asterisco (*), un símbolo de porcentaje (%), o un carácter de subrayado (_).

Normalmente, para los almacenes de datos compatibles con SQL, puede realizar una búsqueda con caracteres comodín en una ruta de acceso parcial con el carácter comodín que aparece al principio, el final o el medio del texto de la cadena de búsqueda en la PathToMatch propiedad . Por ejemplo, para buscar todas las rutas de acceso que comienzan por "~/vdir", la PathToMatch propiedad se establecería en "~/vdir%".

Del mismo modo, una búsqueda con caracteres comodín en un nombre de usuario parcial podría hacer que el carácter comodín aparezca en cualquier punto de la cadena de texto de la UsernameToMatch propiedad. Por ejemplo, para buscar todos los nombres de usuario que comienzan por "John", la UsernameToMatch propiedad tendría un aspecto similar a "John%".

Con el proveedor de personalización predeterminado, los PersonalizationStateInfoobjetos derivados de se devuelven en orden alfabético y se ordenan por una combinación de ruta de acceso y nombre de usuario en orden ascendente. El proveedor determina el orden de los objetos de la colección.

Si userInactiveSinceDate es MaxValue, los valores devueltos de este método son equivalentes a FindUserState.

Tanto pathToMatch como usernameToMatch pueden ser null. El usernameToMatch parámetro puede incluir comas (,) porque algunos almacenes de datos, como los que ejecutan Microsoft SQL Server, permiten comas como caracteres comodín.

Consulte también

• WebPartPersonalization
• controles de elementos web de ASP.NET
• Información general sobre la personalización de elementos web
• Tutorial: Implementar la personalización de elementos web con un control de usuario
• Personalización de elementos web

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

Parámetros

Devoluciones

Clase PersonalizationStateInfoCollection que contiene la información de estado de personalización por usuario.

Excepciones

Comentarios

Este método devuelve una colección de instancias, información de estado de UserPersonalizationStateInfo personalización por usuario donde el valor del pathToMatch parámetro coincide con la ruta de acceso de una página, usernameToMatch coincide con un nombre de usuario que tiene datos de personalización asociados a esa página y los usuarios se consideran inactivos. Es decir, para cada registro devuelto, el valor de propiedad del LastActivityDate usuario es menor o igual que userInactiveSinceDate. La colección solo UserPersonalizationStateInfo contiene instancias.

Este método pasa caracteres comodín de parámetro al proveedor de personalización subyacente, por lo que el modo en que el almacén de datos controla estos caracteres depende de cómo el proveedor controla los caracteres, como un asterisco (*), un símbolo de porcentaje (%), o un carácter de subrayado (_).

Normalmente, para los almacenes de datos compatibles con SQL, puede realizar una búsqueda con caracteres comodín en una ruta de acceso parcial con el carácter comodín que aparece al principio, el final o el medio del texto de la cadena de búsqueda en la PathToMatch propiedad . Por ejemplo, para buscar todas las rutas de acceso que comienzan por "~/vdir", la PathToMatch propiedad se establecería en "~/vdir%".

Del mismo modo, una búsqueda con caracteres comodín en un nombre de usuario parcial podría hacer que el carácter comodín aparezca en cualquier punto de la cadena de texto de la UsernameToMatch propiedad. Por ejemplo, para buscar todos los nombres de usuario que comienzan por "John", la UsernameToMatch propiedad tendría un aspecto similar a "John%".

Con el proveedor de personalización predeterminado, los PersonalizationStateInfoobjetos derivados de se devuelven en orden alfabético y se ordenan por una combinación de ruta de acceso y nombre de usuario en orden ascendente. El proveedor determina el orden de los objetos de la colección.

Si userInactiveSinceDate es MaxValue, los valores devueltos de este método son equivalentes a FindUserState.

Tanto pathToMatch como usernameToMatch pueden ser null. El usernameToMatch parámetro puede tener comas (,) porque algunos almacenes de datos, como los que ejecutan Microsoft SQL Server, permiten comas como caracteres comodín.

Los datos devueltos están restringidos por pageIndex y pageSize, donde pageIndex controla los registros que se van a devolver y pageSize controla el número de registros que se van a devolver. Por ejemplo, si pageIndex se estableció en 0 y pageSize se estableció en 25, los datos devueltos serían las 25 primeras entradas. Si pageIndex se estableció en 1 y pageSize se estableció en 25, los datos devueltos serían entradas de 26 a 50. El totalRecords parámetro devuelve el número total de registros disponibles.

Consulte también

• WebPartPersonalization
• controles de elementos web de ASP.NET
• Información general sobre la personalización de elementos web
• Tutorial: Implementar la personalización de elementos web con un control de usuario
• Personalización de elementos web