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

Devoluções

A PersonalizationStateInfoCollection que contém informação de estado de personalização por utilizador.

Exceções

Observações

Este método devolve uma coleção de UserPersonalizationStateInfo instâncias, informação de estado de personalização por utilizador, onde o pathToMatch valor do parâmetro corresponde ao caminho de uma página, usernameToMatch corresponde a um nome de utilizador que tenha dados de personalização associados a essa página, e os utilizadores são considerados inativos. Ou seja, para cada registo devolvido o valor da propriedade do LastActivityDate utilizador é menor ou igual a userInactiveSinceDate. A coleção devolvida contém apenas UserPersonalizationStateInfo instâncias.

Este método passa os caracteres curinga de consulta para o armazenamento de dados subjacente. O suporte a caracteres coringa depende atualmente de como cada fornecedor lida com caracteres, como um asterisco (*), um símbolo percentual (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados compatíveis com SQL, pode realizar uma pesquisa coringa num caminho parcial, com o carácter curinga a aparecer no início, no fim ou no meio do texto da cadeia de pesquisa na PathToMatch propriedade. Por exemplo, para encontrar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, uma pesquisa coringa num nome de utilizador parcial pode fazer com que o carácter curinga apareça em qualquer ponto da cadeia de texto da UsernameToMatch propriedade. Por exemplo, para encontrar todos os nomes de utilizador que começam por "John", a UsernameToMatch propriedade pareceria "John%".

Usando o fornecedor de personalização por defeito, os PersonalizationStateInfoobjetos derivados em são devolvidos por ordem alfabética e ordenados por uma combinação de caminho e nome de utilizador em ordem crescente. A ordem dos objetos na coleção é determinada pelo fornecedor.

Se userInactiveSinceDate for MaxValue, então os valores devolvidos deste método são equivalentes a FindUserState.

Tanto pathToMatch como podem usernameToMatch ser null. O parâmetro usernameToMatch pode incluir vírgulas (,) porque alguns armazenamentos de dados, como os que executam Microsoft SQL Server, permitem vírgulas como caracteres curinga.

Ver também

• WebPartPersonalization
• ASP.NET Controlos de Web Parts
• Visão Geral da Personalização de Web Parts
• Guia: Implementar a Personalização de Web Parts com Controlo do Utilizador
• Personalização de Web Parts

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

Devoluções

A PersonalizationStateInfoCollection que contém informação de estado de personalização por utilizador.

Exceções

Observações

Este método devolve uma coleção de UserPersonalizationStateInfo instâncias, informação de estado de personalização por utilizador, onde o pathToMatch valor do parâmetro corresponde ao caminho de uma página, usernameToMatch corresponde a um nome de utilizador que tenha dados de personalização associados a essa página, e os utilizadores são considerados inativos. Ou seja, para cada registo devolvido o valor da propriedade do LastActivityDate utilizador é menor ou igual a userInactiveSinceDate. A coleção contém apenas UserPersonalizationStateInfo exemplos.

Este método passa caracteres curinga de parâmetros ao fornecedor de personalização subjacente, pelo que a forma como o armazenamento de dados lida com estes caracteres depende de como o fornecedor lida com caracteres como um asterisco (*), um símbolo percentual (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados compatíveis com SQL, pode realizar uma pesquisa coringa num caminho parcial, com o carácter curinga a aparecer no início, no fim ou no meio do texto da cadeia de pesquisa na PathToMatch propriedade. Por exemplo, para encontrar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, uma pesquisa coringa num nome de utilizador parcial pode fazer com que o carácter curinga apareça em qualquer ponto da cadeia de texto da UsernameToMatch propriedade. Por exemplo, para encontrar todos os nomes de utilizador que começam por "John", a UsernameToMatch propriedade pareceria "John%".

Usando o fornecedor de personalização por defeito, os PersonalizationStateInfoobjetos derivados em são devolvidos por ordem alfabética e ordenados por uma combinação de caminho e nome de utilizador em ordem crescente. A ordem dos objetos na coleção é determinada pelo fornecedor.

Se userInactiveSinceDate for MaxValue, então os valores devolvidos deste método são equivalentes a FindUserState.

Tanto pathToMatch como podem usernameToMatch ser null. O parâmetro usernameToMatch pode ter vírgulas (,) porque alguns repositórios de dados, como os que executam Microsoft SQL Server, permitem vírgulas como caracteres curinga.

Os dados devolvidos são limitados por pageIndex e pageSize, onde pageIndex controla quais registos devolver e pageSize controla o número de registos a devolver. Por exemplo, se pageIndex estivesse definido para 0 e pageSize para 25, os dados devolvidos seriam as primeiras 25 entradas. Se pageIndex estivesse definido para 1 e pageSize definido para 25, os dados devolvidos seriam as entradas 26 a 50. O totalRecords parâmetro devolve o número total de registos disponíveis.

Ver também

• WebPartPersonalization
• ASP.NET Controlos de Web Parts
• Visão Geral da Personalização de Web Parts
• Guia: Implementar a Personalização de Web Parts com Controlo do Utilizador
• Personalização de Web Parts